Συμμόρφωση στόλου — 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, πέραν των ημερήσιων και εβδομαδιαίων ορίων για την άφιξη στο επιχειρησιακό κέντρο ή στο σπίτι για εβδομαδιαία ανάπαυση) με την οφειλόμενη αποζημίωση και την προθεσμία της, η επιστροφή ανά 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 χωρίς offset διαβάζεται στο tz) ή unix seconds. Προαιρετικά στις ανάπαυσεις: 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 για να φτάσει ο οδηγός στο επιχειρησιακό κέντρο ή στο σπίτι για εβδομαδιαία ανάπαυση). Τα κενά μεταξύ δραστηριοτήτων μετρούν ως ανάπαυση (αναφέρονται στα 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 | Η τοποθεσία που στάλθηκε για εκείνη την ανάπαυση (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"
}
]
}'
Ενημερώθηκε