Усогласеност на возниот парк — Validate API Online
Проверете ја евидентираната активност на возачот според правилата за возење и одмор од EU 561/2006 (или AETR) и работното време според Директивата 2002/15/EC. Испратете ја временската линија како JSON телo на POST барање (JSON body) — тековната смена плус до 28 дена или повеќе историја налик на тахограф — и добијте ги сите прекршоци со член од правилото, временска ознака и сериозност (категории според Регулативата (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, над дневните и неделните граници за да се стигне до оперативниот центар или дома за неделен одмор) со должната компензација и нејзиниот рок, враќањето во базата или дома на секои 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 body, задолжително) Активности на возачот, од најстара кон најнова или во произволен редослед. Секоја активност: {type: drive | other_work | availability | break | rest, start, end} — ISO-8601 (датумот и времето без поместување се читаат во tz) или unix секунди. Опционално кај rest: ferry (true на траект или воз), sleeper_cabin, scheduled_journey_h, in_vehicle, location (residence | operational_centre | elsewhere — проверка на враќање на секои 4 недели според EU 561 Art. 8(8a)). Опционално кај drive: art12_exceed (true = возење над границата според EU 561 Art. 12 за да се стигне до оперативниот центар или до дома за неделен одмор). Празнините меѓу активностите се сметаат за одмор (се пријавуваат во 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} = единечна повремена меѓународна услуга за превоз на патници: неделниот одмор може да се одложи до дванаесет 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 ч и 336 ч (правниот тест користи календарски недели). |
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 | Локацијата испратена за тој odmor (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"
}
]
}'
Ажурирано