Conformitatea flotei — Validate API Online
Verifică activitatea înregistrată a unui șofer în raport cu normele privind conducerea și odihna din Regulamentul EU 561/2006 (sau AETR) și cu timpul de lucru din Directiva 2002/15/CE. Trimiteți cronologia ca JSON în corpul unei cereri POST — tura curentă plus până la 28 de zile sau mai mult de istoric de tip tahograf — și primiți toate încălcările, cu articolul normei, marcajul de timp și gravitatea (categoriile din Regulamentul (UE) 2016/403), avertismente și ce mai are șoferul disponibil în acest moment: conducerea zilnică, bugetele de 56 h pe săptămână și 90 h pe două săptămâni, când scadă următoarea pauză, odihna zilnică și odihna săptămânală, zilele prelungite și odihnele reduse folosite, precum și orice compensare datorată pentru odihna săptămânală redusă, cu termenul limită. Acoperă pauzele de 4 h 30 (inclusiv împărțirea 15 + 30), zilele de 9/10 h, odihna zilnică de 11/9 h și 3 + 9 h, șase perioade de 24 de ore între odihnele săptămânale, secvențele de odihnă săptămânală redusă și compensarea, echipajul dublu (odihnă de 9 h în 30 h), odihna întreruptă pe feribot/tren, iar conform 2002/15 media de 48 h, săptămâna de 60 h, pauzele după 6 h și plafonul de 10 h pentru munca de noapte. Începând cu v1.1: excepția de la Art. 12 (până la 1 h, sau 2 h după o pauză de 30 min, peste limitele zilnice și săptămânale, pentru a ajunge la centrul operațional sau acasă pentru o odihnă săptămânală) cu compensarea datorată și termenul ei, revenirea la bază sau acasă la 4 săptămâni conform Art. 8(8a), derogarea de 12 zile conform Art. 8(6a) pentru serviciile ocazionale internaționale de transport cu autocarul și intervalele naționale de noapte din 2002/15, pe țări. route_plan_state poate fi transmis direct către route-plan.
POST https://nakordoni.eu/api/v2/data/fleet/compliance/validate
— clasă de cotă: heavy
| Parametru | Descriere |
|---|---|
activities | (corp JSON, obligatoriu) Activitățile șoferului, începând cu cea mai veche sau în orice ordine. Fiecare activitate: {type: drive | other_work | availability | break | rest, start, end} — ISO-8601 (o dată cu oră fără offset este interpretată în tz) sau secunde unix. Opțional pentru rests: ferry (true pe un feribot sau tren), sleeper_cabin, scheduled_journey_h, in_vehicle, location (residence | operational_centre | elsewhere — verificarea întoarcerii la 4 săptămâni conform EU 561 Art. 8(8a)). Opțional pentru drives: art12_exceed (true = condus peste limită conform EU 561 Art. 12 pentru a ajunge la centrul operațional sau acasă pentru o odihnă săptămânală). Intervalele dintre activități sunt considerate odihnă (raportate în warnings); suprapunerile sunt respinse. |
history | (body JSON) Activități mai vechi, în același format (de ex. ultimele 28 de zile din tahograf); sunt îmbinate cu activities. |
tz | (body JSON) Fusul orar IANA pentru săptămânile calendaristice (luni 00:00) și intervalul de noapte, implicit UTC. |
ruleset | (body JSON) eu561 (implicit) sau aetr. limits listează diferențele AETR care se aplică. |
crew | (body JSON) single (implicit) sau double (echipaj multiplu). |
now | (body JSON) Momentul evaluării, implicit sfârșitul ultimei activități; timpul de după ultima activitate se consideră odihnă. |
last_weekly_rest_end | (body JSON) Sfârșitul ultimei odihne săptămânale dinaintea cronologiei, când cronologia nu o conține. |
international_goods | (body JSON, eu561) true = șoferul efectuează transport internațional de mărfuri în afara statului membru de stabilire (sunt permise două odihne săptămânale reduse consecutive conform Art. 8(6)). |
passenger_12day | (corp JSON) true sau {abroad_24h: bool} = serviciu ocazional unic de transport internațional de pasageri: repausul săptămânal poate fi amânat până la douăsprezece perioade de 24 de ore după un repaus săptămânal regulat (EU 561 Art. 8(6a), AETR Art. 8(6)(b)); sunt verificate repausurile de după acesta și conducerea pe timp de noapte (22:00-06:00: echipaj multiplu sau o perioadă de conducere de 3 h). |
country | (corp JSON) Codul de țară ISO pentru intervalul național de noapte conform 2002/15 (identic cu wtd.country). |
include_wtd | (body JSON) false = omite verificările Directivei 2002/15/CE (implicit true). |
wtd | (corp JSON) Opțiuni 2002/15: reference_weeks 1-52 (implicit 17), reference_mode rolling | fixed, reference_start, night_window HH:MM-HH:MM (implicit 00:00-04:00), country (cod ISO al unei țări UE/SEE: intervalul național de noapte, vezi limitele), carriage goods | passengers. |
Câmpurile răspunsului — în interiorul obiectului data din plicul răspunsului. [] marchează o listă, deci data.items[].name este câmpul name al fiecărui element. Un câmp este null, lipsește sau este o listă goală atunci când nu avem o valoare — niciodată un substitut.
| Câmp | Descriere |
|---|---|
data.compliant | true când nu a fost găsită nicio încălcare; violation_count și by_severity (most_serious, very_serious, serious, minor) le numără. |
data.violations[] | code, ref (articolul normei, de ex. "EU 561/2006 Art. 7"), severity, at (momentul depășirii limitei), value_min / limit_min / excess_min, period_start sau week_start, open (încă în desfășurare la momentul evaluării), message. Intrările 2002/15 conțin banded=false. |
data.warnings[] | Aspecte care necesită acțiune, dar care nu sunt încă încălcări: code, message, opțional ref și at (de ex. 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 (cel mai mic dintre bugetele zilnic, săptămânal și bisăptămânal), 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 | Starea șoferului în numele parametrilor 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[] | Fiecare perioadă de serviciu dintre odihnele zilnice/săptămânale: start, end, drive_min, extended, rest_type, rest_start, rest_end, rest_min (+ ferry_interruptions). |
data.weekly_rests[] | Odihnele săptămânale găsite: start, end, duration_min, type regular | reduced, periods_since_previous, compensation_owed_min, derogation. |
data.weeks | Pe săptămână calendaristică: driving.drive_min și working_time.work_min, cu complete. |
data.rolling | Doar informativ: cea mai lungă durată de conducere în orice fereastră de 168 h și 336 h (testul legal folosește săptămâni calendaristice). |
data.assumptions[] | Cum au fost interpretate datele de intrare incomplete (de ex. nicio odihnă săptămânală înainte de cronologia cunoscută). |
data.exceptions | art12[]: fiecare utilizare a excepției 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 | Locația transmisă pentru această perioadă de odihnă (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 (sursă națională). |
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"
}
]
}'
Actualizat