Відповідність автопарку — Validate API Online
Перевіряє зафіксовану активність водія на відповідність правилам керування та відпочинку EU 561/2006 (або AETR) і Директиві 2002/15/EC щодо робочого часу. Надішліть хронологію як JSON POST-тіло — поточну зміну плюс до 28 днів або більше історії, подібної до тахографа — і отримайте всі порушення з артикулом правила, часовою позначкою та серйозністю (категорії Регламенту (ЄС) 2016/403), попередження, а також те, що в водія залишилося просто зараз: денний ліміт керування, бюджети 56 год на тиждень і 90 год на два тижні, коли настануть наступна перерва, щоденний відпочинок і щотижневий відпочинок, використані подовжені дні та скорочені відпочинки, а також будь-яку належну компенсацію за скорочений щотижневий відпочинок із терміном її надання. Охоплює перерви 4 год 30 хв (зокрема розділення 15 + 30), дні 9/10 год, щоденний відпочинок 11/9 год і 3 + 9 год, шість 24-годинних періодів між щотижневими відпочинками, послідовності скорочених щотижневих відпочинків і компенсацію, подвійний екіпаж (відпочинок 9 год протягом 30 год), перерваний відпочинок на поромі/потязі, а також за 2002/15 середнє за 48 год, 60-годинний тиждень, перерви після 6 год і обмеження 10 год нічної роботи. Починаючи з v1.1: виняток за Art. 12 (до 1 год, або 2 год після перерви 30 хв, понад денні та тижневі ліміти, щоб дістатися до операційного центру або додому для щотижневого відпочинку) із належною компенсацією та її терміном, повернення на базу або додому кожні 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 = водій перебуває в міжнародних вантажних перевезеннях за межами держави-члена місця заснування (дозволено два послідовні скорочені тижневі відпочинки відповідно до 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 = пропустити перевірки Директиви 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 країни ЄС/ЄЕП: національне нічне вікно, див. обмеження), 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"
}
]
}'
Оновлено