Відповідність автопарку — Plan Check API Online
Перевіряйте заплановані зміни або дні рейсу до відправлення. Надішліть зміни та країни, в яких вони відбуваються, як JSON-тіло POST-запиту; для кожної зміни повертаються заборони руху вантажівок, які її стосуються (вихідні, неділя, свята та інші заборони з нашого календаря заборон для вантажівок, відфільтровані за масою транспортного засобу), державні свята та вихідні дні, на які вона припадає, порушення EU 561 / AETR і 2002/15, які спричинив би план, а також найраніший законний початок: після необхідного добового або тижневого відпочинку та поза всіма забороняючими обмеженнями.
POST https://nakordoni.eu/api/v2/data/fleet/compliance/plan-check
— клас квоти: heavy
| Параметр | Опис |
|---|---|
shifts | (тіло JSON, обов'язкове, макс. 60, проміжок макс. 62 дні) [{start, end, countries?, drive_min?, other_work_min?, activities?}]. Без activities зміна формується як інша робота, а потім водіння блоками по 4 год 30 хв з перервами по 45 хв. Кожна activity: {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 для досягнення операційного центру або дому для щотижневого відпочинку). Проміжки між activities вважаються відпочинком (зазначаються в warnings); перекриття відхиляються. |
countries | (JSON-тіло) Коди країн ISO для змін, які не вказують власних, напр. ["DE","AT"]. |
tz | (JSON-тіло) Часовий пояс IANA плану (дата й час без зсуву), за замовчуванням UTC. Вікна заборон використовують власний часовий пояс кожної країни. |
weight_t | (JSON-тіло) Маса транспортного засобу в тоннах; заборони з ваговим порогом, що дорівнює цьому значенню або перевищує його, пропускаються. Якщо не вказано — враховуються всі заборони. |
history | (JSON-тіло) Нещодавні активності перед планом (формат як у validate), щоб відпочинки та бюджети переносилися. |
last_weekly_rest_end | (JSON-тіло) Кінець останнього тижневого відпочинку перед планом. |
ruleset | (JSON-тіло) eu561 (за замовчуванням) або aetr. crew single | double. international_goods, include_wtd, wtd — як у validate. |
allow_reduced_daily_rest | (JSON-тіло) true = пропозиції можуть використовувати скорочений добовий відпочинок 9 год (за замовчуванням: 11 год). |
allow_reduced_weekly_rest | (JSON-тіло) true = пропозиції можуть використовувати скорочений тижневий відпочинок 24 год (за замовчуванням: 45 год). |
blocking_types | (JSON-тіло) Типи заборон, що зсувають запропонований початок (за замовчуванням Sunday, Saturday, Holiday, Holiday Eve, General; лише загальнонаціональні заборони). Інші все одно позначаються. |
Поля відповіді — усередині об’єкта data у конверті відповіді. [] позначає список, тож data.items[].name — це поле name кожного елемента. Поле буває null, відсутнє або порожній список, коли значення в нас немає, — заглушок ми не підставляємо.
| Поле | Опис |
|---|---|
data.shifts[] | Для кожної зміни: index, start, end, countries, duration_min, flags[], violations[], suggested_start, suggested_end, delay_min, delay_reasons[] (daily_rest, weekly_rest, truck_ban:<CC>:<type>). |
data.shifts[].flags[] | type truck_ban (country, date, restriction_type, from, until, scope, details, min_weight_t, blocking, overlap_min), public_holiday (country, date, names, truck_ban_recorded) або weekend (country, date, day). |
data.violations[] | Кожне порушення плану за EU 561 / AETR / 2002/15 у форматі validate. |
data.remaining_after_plan | Бюджети керування та наступні відпочинки після останньої запланованої зміни (validate remaining.driving). |
data.summary | shift_count, shifts_flagged, shifts_moved, violation_count, ban_windows_considered, countries, ruleset, crew. |
data.warnings[] | напр. shift_layout_overflows, holidays_unavailable; data.assumptions[] описує, як були інтерпретовані відсутні вхідні дані. |
curl -X POST "https://nakordoni.eu/api/v2/data/fleet/compliance/plan-check" \
-H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX" \
-H "Content-Type: application/json" \
-d '{
"countries": [
"DE"
],
"tz": "Europe/Berlin",
"weight_t": 40,
"shifts": [
{
"start": "2026-11-07T06:00:00",
"end": "2026-11-07T16:45:00"
},
{
"start": "2026-11-08T06:00:00",
"end": "2026-11-08T15:00:00"
}
]
}'
Оновлено