Zgłaszanie newsów i flota NakBus są teraz w panelu partnera
Aby zalogować się do panelu Nakordoni Partners, użyj tego samego loginu (adres e-mail i hasło) co na koncie programisty i zarządzaj tam wiadomościami oraz flotą autobusów (NakDriver / NakManager) z rolami zespołu. Twoje klucze API, endpointy i aplikacje pozostają bez zmian, a strony tutaj nadal działają. Otwórz Nakordoni Partners

← Wszystkie endpointy

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

ParametrOpis
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.

PoleOpis
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_planBudżety prowadzenia i kolejne odpoczynki po ostatniej planowanej zmianie (validate remaining.driving).
data.summaryshift_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"
        }
    ]
}'
🔑 Zaloguj się jako deweloper, aby wypróbować ten endpoint na żywo w sandboxie — 10 darmowych wywołań testowych na produkt dziennie. Zaloguj się

Zaktualizowano