תאימות צי רכב — 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 (עד שעה אחת, או שעתיים לאחר הפסקה של 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, חובה) פעילויות הנהג, מהישנה לחדשה או בכל סדר. כל פעילות: {type: drive | other_work | availability | break | rest, start, end} — ISO-8601 (datetime ללא היסט נקרא לפי 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 = הנהג בהובלת סחורות בינלאומית מחוץ למדינת החבר שבה הוא מוצב (מותרות שתי מנוחות שבועיות מקוצרות רצופות לפי Art. 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 = דילוג על בדיקות Directive 2002/15/EC (ברירת מחדל 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 של האיחוד האירופי/EEA: חלון לילה לאומי, ראו מגבלות), 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 | המיקום שנשלח עבור אותה מנוחה (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"
}
]
}'
עודכן