Përputhshmëria e flotës — Validate API Online
Kontrollo aktivitetin e regjistruar të shoferit sipas rregullave të drejtimit dhe pushimit të EU 561/2006 (ose AETR) dhe orarit të punës të Direktivës 2002/15/EC. Dërgoni kronologjinë si trup POST JSON — turnin aktual plus deri në 28 ditë ose më shumë histori të ngjashme me tahografin — dhe merrni çdo shkelje me nenin e rregullit, vulën kohore dhe seriozitetin (nivelet e Rregullores (EU) 2016/403), paralajmërimet, si dhe çfarë i ka mbetur shoferit tani: drejtimin ditor, buxhetet javore 56 h dhe dyjavore 90 h, kur duhet pauza e radhës, pushimi ditor dhe pushimi javor, ditët e zgjatura dhe pushimet e reduktuara të përdorura, si dhe çdo kompensim të pushimit javor të reduktuar që duhet dhënë me afatin e tij. Mbulon pauzat 4 h 30 (përfshirë ndarjen 15 + 30), ditët 9/10 h, pushimin ditor 11/9 h dhe 3 + 9 h, gjashtë periudha 24-orëshe mes pushimeve javore, sekuencat dhe kompensimin e pushimit javor të reduktuar, ekuipazhin e dyfishtë (pushim 9 h brenda 30 h), pushimin e ndërprerë me traget/tren, dhe sipas 2002/15 mesataren 48 h, javën 60 h, pauzat pas 6 h dhe kufirin 10 h të punës natën. Që nga v1.1: përjashtimi i Art. 12 (deri në 1 h, ose 2 h pas një pauze 30 min, përtej kufijve ditorë dhe javorë për të arritur qendrën operative ose shtëpinë për pushim javor) me kompensimin e detyrueshëm dhe afatin e tij, kthimi 4-javor në bazë ose në shtëpi sipas Art. 8(8a), derogimi 12-ditor sipas Art. 8(6a) për shërbimet ndërkombëtare okazionale me autobus, dhe dritaret kombëtare të natës sipas 2002/15 sipas shtetit. route_plan_state mund t'i kalohet drejtpërdrejt route-plan.
POST https://nakordoni.eu/api/v2/data/fleet/compliance/validate
— klasa e kuotës: heavy
| Parametri | Përshkrimi |
|---|---|
activities | (trupi JSON, i detyrueshëm) Aktivitetet e shoferit, nga më e vjetra ose në çfarëdo renditjeje. Çdo aktivitet: {type: drive | other_work | availability | break | rest, start, end} — ISO-8601 (një datetime pa offset lexohet në tz) ose sekonda unix. Opsionale te pushimet (rest): ferry (true në një traget ose tren), sleeper_cabin, scheduled_journey_h, in_vehicle, location (residence | operational_centre | elsewhere — kontrolli i kthimit çdo 4 javë sipas EU 561 Art. 8(8a)). Opsionale te drejtimet (drive): art12_exceed (true = drejtim përtej kufirit sipas EU 561 Art. 12 për të arritur në qendrën operative ose në shtëpi për pushimin javor). Boshllëqet mes aktiviteteve llogariten si pushim (raportohen te warnings); mbivendosjet refuzohen. |
history | (trup JSON) Aktivitete më të vjetra në të njëjtin format (p.sh. 28 ditët e fundit nga tahografi); bashkohen me activities. |
tz | (trup JSON) Zona kohore IANA për javët kalendarike (e hënë 00:00) dhe dritaren e natës, e paracaktuar UTC. |
ruleset | (trup JSON) eu561 (e paracaktuar) ose aetr. limits liston dallimet e AETR që zbatohen. |
crew | (trup JSON) single (e paracaktuar) ose double (shoferë të shumtë). |
now | (trup JSON) Koha e vlerësimit, e paracaktuar fundi i aktivitetit të fundit; koha pas aktivitetit të fundit llogaritet si pushim. |
last_weekly_rest_end | (trup JSON) Fundi i pushimit të fundit javor para kronologjisë, kur kronologjia nuk e përmban. |
international_goods | (trup JSON, eu561) true = shoferi është në transport ndërkombëtar mallrash jashtë shtetit anëtar të themelimit (lejohen dy pushime javore të reduktuara të njëpasnjëshme sipas Art. 8(6)). |
passenger_12day | (trupi JSON) true ose {abroad_24h: bool} = një shërbim i vetëm ndërkombëtar i rastësishëm për pasagjerë: pushimi javor mund të shtyhet deri në dymbëdhjetë periudha 24-orëshe pas një pushimi javor të rregullt (EU 561 Art. 8(6a), AETR Art. 8(6)(b)); kontrollohen pushimet pas tij dhe drejtimi gjatë natës (22:00-06:00: drejtim me shumë shoferë ose periudhë drejtimi 3 h). |
country | (trupi JSON) Kodi ISO i shtetit për dritaren kombëtare të natës sipas 2002/15 (i njëjtë me wtd.country). |
include_wtd | (trup JSON) false = kalo kontrollet e Direktivës 2002/15/KE (e paracaktuar true). |
wtd | (trup JSON) Opsionet 2002/15: reference_weeks 1-52 (parazgjedhja 17), reference_mode rolling | fixed, reference_start, night_window HH:MM-HH:MM (parazgjedhja 00:00-04:00), country (kod ISO i BE/EEA: dritarja kombëtare e natës, shih kufijtë), carriage goods | passengers. |
Fushat e përgjigjes — brenda objektit data të zarfit të përgjigjes. [] shënon një listë, pra data.items[].name është fusha name e çdo elementi. Një fushë është null, mungon ose është listë bosh kur nuk kemi vlerë — kurrë një vendmbajtëse.
| Fusha | Përshkrimi |
|---|---|
data.compliant | true kur nuk është gjetur asnjë shkelje; violation_count dhe by_severity (most_serious, very_serious, serious, minor) i numërojnë ato. |
data.violations[] | code, ref (neni i rregullit, p.sh. "EU 561/2006 Art. 7"), severity, at (kur u tejkalua kufiri), value_min / limit_min / excess_min, period_start ose week_start, open (ende në vazhdim në kohën e vlerësimit), message. Regjistrimet 2002/15 mbajnë banded=false. |
data.warnings[] | Gjëra për t'u trajtuar që nuk janë ende shkelje: code, message, ref dhe at opsionale (p.sh. 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 (më e vogla nga buxhetet ditore, javore dhe dyjavore), 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 | Gjendja e shoferit me emrat e parametrave të 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[] | Çdo periudhë shërbimi midis pushimeve ditore/javore: start, end, drive_min, extended, rest_type, rest_start, rest_end, rest_min (+ ferry_interruptions). |
data.weekly_rests[] | Pushimet javore të gjetura: start, end, duration_min, type regular | reduced, periods_since_previous, compensation_owed_min, derogation. |
data.weeks | Për çdo javë kalendarike: driving.drive_min dhe working_time.work_min, me complete. |
data.rolling | Vetëm informacion: drejtimi më i madh në çdo dritare 168 orë dhe 336 orë (testi ligjor përdor javët kalendarike). |
data.assumptions[] | Si u interpretua të dhënat e paplota (p.sh. nuk ka pushim javor para kronologjisë së njohur). |
data.exceptions | art12[]: çdo përdorim i përjashtimit të 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 | Vendndodhja e dërguar për atë pushim (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 (burimi kombëtar). |
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"
}
]
}'
Përditësuar