Zgodność floty — Plan Check API Online
Sprawdzaj planowane zmiany lub dni trasy przed wysłaniem. Prześlij zmiany i kraje, w których się odbywają, jako treść JSON żądania POST; dla każdej zmiany zwracane są zakazy ruchu ciężarówek, które jej dotyczą (zakazy weekendowe, niedzielne, świąteczne i inne z naszego kalendarza zakazów dla ciężarówek, filtrowane według masy pojazdu), święta państwowe i dni weekendowe, na które przypada, naruszenia EU 561 / AETR i 2002/15, które spowodowałby plan, oraz najwcześniejszy legalny start: po wymaganym odpoczynku dziennym lub tygodniowym i poza wszystkimi blokującymi zakazami.
POST https://nakordoni.eu/api/v2/data/fleet/compliance/plan-check
— klasa limitu: heavy
| Parametr | Opis |
|---|---|
shifts | (treść JSON, wymagana, maks. 60, rozpiętość maks. 62 dni) [{start, end, countries?, drive_min?, other_work_min?, activities?}]. Bez activities zmiana jest układana jako inna praca, a następnie jazda w blokach po 4 h 30 z przerwami po 45 min. Każda activity: {type: drive | other_work | availability | break | rest, start, end} — ISO-8601 (datetime bez przesunięcia jest odczytywany w tz) lub sekundy unix. Opcjonalne dla rest: ferry (true na promie lub w pociągu), sleeper_cabin, scheduled_journey_h, in_vehicle, location (residence | operational_centre | elsewhere — kontrola powrotu co 4 tygodnie wg EU 561 Art. 8(8a)). Opcjonalne dla drive: art12_exceed (true = jazda ponad limit wg EU 561 Art. 12 w celu dotarcia do centrum operacyjnego lub domu na odpoczynek tygodniowy). Przerwy między activities liczą się jako odpoczynek (zgłaszane w warnings); nakładania są odrzucane. |
countries | (treść JSON) Kody krajów ISO używane dla zmian, które nie podają własnych, np. ["DE","AT"]. |
tz | (treść JSON) Strefa czasowa IANA planu (data i czas bez przesunięcia), domyślnie UTC. Okna zakazów używają własnej strefy czasowej każdego kraju. |
weight_t | (treść JSON) Masa pojazdu w tonach; zakazy z progiem masy równym tej wartości lub niższym od niej są pomijane. Brak wartości = uwzględniane są wszystkie zakazy. |
history | (treść JSON) Ostatnie aktywności przed planem (format jak w validate), aby odpoczynki i budżety były przenoszone. |
last_weekly_rest_end | (treść JSON) Koniec ostatniego odpoczynku tygodniowego przed planem. |
ruleset | (treść JSON) eu561 (domyślnie) lub aetr. crew single | double. international_goods, include_wtd, wtd jak w validate. |
allow_reduced_daily_rest | (treść JSON) true = propozycje mogą wykorzystywać skrócony odpoczynek dzienny 9 h (domyślnie: 11 h). |
allow_reduced_weekly_rest | (treść JSON) true = propozycje mogą wykorzystywać skrócony odpoczynek tygodniowy 24 h (domyślnie: 45 h). |
blocking_types | (treść JSON) Typy zakazów przesuwające proponowany start (domyślnie Sunday, Saturday, Holiday, Holiday Eve, General; tylko zakazy ogólnokrajowe). Pozostałe są nadal oznaczane. |
Pola odpowiedzi — wewnątrz obiektu data w kopercie odpowiedzi. [] oznacza listę, więc data.items[].name to pole name każdego elementu. Pole bywa null, nieobecne lub jest pustą listą, gdy nie mamy wartości — nigdy nie wstawiamy atrapy.
| Pole | Opis |
|---|---|
data.shifts[] | Dla każdej zmiany: 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) lub weekend (country, date, day). |
data.violations[] | Każde naruszenie EU 561 / AETR / 2002/15 w planie, w formacie validate. |
data.remaining_after_plan | Budżety prowadzenia i kolejne odpoczynki po ostatniej planowanej zmianie (validate remaining.driving). |
data.summary | shift_count, shifts_flagged, shifts_moved, violation_count, ban_windows_considered, countries, ruleset, crew. |
data.warnings[] | np. shift_layout_overflows, holidays_unavailable; data.assumptions[] opisuje, jak zinterpretowano brakujące dane wejściowe. |
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"
}
]
}'
Zaktualizowano