Съответствие на автопарка — Validate API Online
Проверете записаната дейност на водача спрямо правилата за шофиране и почивка по EU 561/2006 (или AETR) и работното време по Директива 2002/15/ЕО. Изпратете времевата линия като тяло JSON POST – текущата смяна плюс история, подобна на тахографска, за 28 дни или повече – и получете всички нарушения с член на правилото, времеви печат и тежест (категории по Регламент (ЕС) 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-часова седмица, почивки след 6 h и ограничение от 10 h нощен труд. От v1.1: изключението по чл. 12 (до 1 h или 2 h след 30 min почивка, над дневните и седмичните ограничения, за достигане до оперативния център или дома за седмична почивка) с дължимото компенсиране и срока му, 4-седмичното връщане в базата или у дома по чл. 8, параграф 8а, 12-дневното дерогиране по чл. 8, параграф 6а за инцидентни международни автобусни услуги и националните нощни прозорци по 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 (дата и час без отместване се четат в tz) или unix секунди. По избор при почивките: 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"
}
]
}'
Обновено