Усклађеност возног парка — Validate API Online
Проверите забележену активност возача у односу на правила о вожњи и одмору из EU 561/2006 (или AETR) и радно време из Директиве 2002/15/EC. Пошаљите временску линију као JSON POST тело (JSON body) — тренутну смену и историју налик тахографској до 28 дана или више — и добићете сваки прекршај са чланом правила, временском ознаком и тежином (разреди из Regulation (EU) 2016/403), упозорења и шта возачу тренутно преостаје: дневну вожњу, недељне буџете од 56 h и двонедељне од 90 h, када доспевају следећа пауза, дневни одмор и недељни одмор, искоришћене продужене дане и скраћене одморе, као и евентуалну накнаду за скраћени недељни одмор са роком. Обухвата паузе од 4 h 30 (укључујући поделу 15 + 30), дане од 9/10 h, дневни одмор од 11/9 h и 3 + 9 h, шест периода од 24 сата између недељних одмора, низове скраћених недељних одмора и накнаду, двоструку посаду (одмор од 9 h унутар 30 h), прекинут одмор на трајекту/возу, као и по 2002/15 просек од 48 h, недељу од 60 h, паузе после 6 h и ограничење ноћног рада од 10 h. Од верзије v1.1: изузетак из Art. 12 (до 1 h, или 2 h после паузе од 30 min, преко дневних и недељних ограничења ради доласка до оперативног центра или kући ради недељног одмора) са дугованом накнадом и роком, повратак у базу или кући на сваке 4 недеље према Art. 8(8a), дерогација од 12 дана из Art. 8(6a) за повремене међународне аутобуске превозе и национални ноћни прозори по 2002/15 по земљама. route_plan_state се може проследити директно у route-plan.
POST https://nakordoni.eu/api/v2/data/fleet/compliance/validate
— класа квоте: heavy
| Параметар | Опис |
|---|---|
activities | (JSON тело, обавезно) Активности возача, од најстарије или било којим редоследом. Свака активност: {type: drive | other_work | availability | break | rest, start, end} — ISO-8601 (datetime без офсета се чита у tz) или unix секунде. Опционо за одморе: ferry (true на трајекту или возу), sleeper_cabin, scheduled_journey_h, in_vehicle, location (residence | operational_centre | elsewhere — провера повратка у року од 4 недеље по EU 561 Art. 8(8a)). Опционо за вожње: art12_exceed (true = вожња преко ограничења према EU 561 Art. 12 ради доласка до оперативног центра или kући ради недељног одмора). Празнине између активности рачунају се као одмор (пријављују се у warnings); преклапања се одбијају. |
history | (JSON тело) Старије активности у истом формату (нпр. последњих 28 дана из тахографа); спајају се са activities. |
tz | (JSON тело) IANA временска зона за календарске недеље (понедељак 00:00) и ноћни прозор, подразумевано UTC. |
ruleset | (JSON тело) eu561 (подразумевано) или aetr. limits наводи разлике AETR које се примењују. |
crew | (JSON тело) single (подразумевано) или double (вишеструка посада). |
now | (JSON тело) Време процене, подразумевано крај последње активности; време после последње активности рачуна се као одмор. |
last_weekly_rest_end | (JSON тело) Крај последњег недељног одмора пре временске линије, када је временска линија не садржи. |
international_goods | (JSON тело, eu561) true = возач је у међународном превозу робе изван државе чланице седишта (дозвољена су два узастопна скраћена недељна одмора према чл. 8(6)). |
passenger_12day | (JSON тело) true или {abroad_24h: bool} = једна повремена међународна услуга превоза путника: седмични odmor може се одложити до дванаест периода од 24 сата након редовног седмичног одмора (EU 561 Art. 8(6a), AETR Art. 8(6)(b)); проверавају се одмори после њега и ноћна вожња (22:00-06:00: више чланова посаде или период вожње од 3 h). |
country | (JSON тело) ISO код државе за национални ноћни прозор по 2002/15 (исто као wtd.country). |
include_wtd | (JSON тело) false = прескочи провере Директиве 2002/15/ЕЗ (подразумевано true). |
wtd | (JSON тело) Опције 2002/15: reference_weeks 1-52 (подразумевано 17), reference_mode rolling | fixed, reference_start, night_window HH:MM-HH:MM (подразумевано 00:00-04:00), country (ISO код ЕУ/ЕЕП: национални ноћни прозор, погледајте ограничења), carriage goods | passengers. |
Поља одговора — унутар објекта data у коверти одговора. [] означава листу, па је data.items[].name поље name сваког елемента. Поље је null, недостаје или је празна листа када немамо вредност — никада не убацујемо замену.
| Поље | Опис |
|---|---|
data.compliant | true када није пронађен ниједан прекршај; violation_count и by_severity (most_serious, very_serious, serious, minor) их броје. |
data.violations[] | code, ref (члан правила, нпр. "EU 561/2006 Art. 7"), severity, at (када је ограничење прекорачено), value_min / limit_min / excess_min, period_start или week_start, open (још траје у тренутку процене), message. Уноси 2002/15 садрже banded=false. |
data.warnings[] | Ствари на које треба реаговати а које још нису прекршаји: code, message, опционо ref и at (нпр. 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 (најмањи од дневног, седмичног и двонедељног буџета), 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 | Стање возача у називима параметара 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[] | Сваки период рада између дневних/недељних одмора: start, end, drive_min, extended, rest_type, rest_start, rest_end, rest_min (+ ferry_interruptions). |
data.weekly_rests[] | Пронађени недељни одмори: start, end, duration_min, type regular | reduced, periods_since_previous, compensation_owed_min, derogation. |
data.weeks | По календарској недељи: driving.drive_min и working_time.work_min, са complete. |
data.rolling | Само информативно: највише вожње у било ком прозору од 168 h и 336 h (законска провера користи календарске недеље). |
data.assumptions[] | Како су протумачени непотпуни улазни подаци (нпр. нема недељног одмора пре познате временске линије). |
data.exceptions | art12[]: свака употреба изузетка из 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 | Локација послата за тај одмор (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 (национални извор). |
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"
}
]
}'
Ažurirano