Conformitatea flotei — Plan Check API Online
Verificați turele planificate sau zilele de cursă înainte de expediere. Trimiteți turele și țările în care se desfășoară ca body JSON într-un POST; pentru fiecare tură primiți restricțiile de circulație pentru camioane care o afectează (interdicții de weekend, duminică, sărbători legale și altele din calendarul nostru de restricții pentru camioane, filtrate după greutatea vehiculului), sărbătorile legale și zilele de weekend pe care le atinge, încălcările EU 561 / AETR și 2002/15 pe care le-ar cauza planul și cea mai devreme pornire legală: după odihna zilnică sau săptămânală necesară și în afara oricărei restricții blocante.
POST https://nakordoni.eu/api/v2/data/fleet/compliance/plan-check
— clasă de cotă: heavy
| Parametru | Descriere |
|---|---|
shifts | (corp JSON, obligatoriu, max. 60, interval maxim 62 de zile) [{start, end, countries?, drive_min?, other_work_min?, activities?}]. Fără activities, tura este alcătuită astfel: mai întâi alte activități de muncă, apoi condus în blocuri de 4 h 30 cu pauze de 45 min. Fiecare activitate: {type: drive | other_work | availability | break | rest, start, end} — ISO-8601 (o dată cu oră fără offset este citită în tz) sau secunde unix. Opțional pentru rests: ferry (true pe un feribot sau tren), sleeper_cabin, scheduled_journey_h, in_vehicle, location (residence | operational_centre | elsewhere — verificarea returului la 4 săptămâni conform EU 561 Art. 8(8a)). Opțional pentru drives: art12_exceed (true = condus peste limită conform EU 561 Art. 12 pentru a ajunge la centrul de operare sau acasă pentru o odihnă săptămânală). Intervalele dintre activități se contabilizează ca odihnă (raportate în warnings); suprapunerile sunt respinse. |
countries | (body JSON) Coduri ISO de țară folosite pentru turele care nu își listează propriile țări, de ex. ["DE","AT"]. |
tz | (body JSON) Fusul orar IANA al planului (date-oră fără offset), implicit UTC. Intervalele de restricție folosesc fusul orar propriu fiecărei țări. |
weight_t | (body JSON) Greutatea vehiculului în tone; restricțiile cu prag de greutate egal sau mai mare decât aceasta sunt omise. Omis = sunt incluse toate restricțiile. |
history | (body JSON) Activități recente dinaintea planului (format ca în validate), astfel încât odihnele și bugetele să se reporteze. |
last_weekly_rest_end | (body JSON) Sfârșitul ultimei odihne săptămânale dinaintea planului. |
ruleset | (body JSON) eu561 (implicit) sau aetr. crew single | double. international_goods, include_wtd, wtd ca în validate. |
allow_reduced_daily_rest | (body JSON) true = sugestiile pot folosi o odihnă zilnică redusă de 9 h (implicit: 11 h). |
allow_reduced_weekly_rest | (body JSON) true = sugestiile pot folosi o odihnă săptămânală redusă de 24 h (implicit: 45 h). |
blocking_types | (body JSON) Tipurile de restricții care mută o pornire sugerată (implicit Sunday, Saturday, Holiday, Holiday Eve, General; doar restricții la nivel național). Celelalte sunt în continuare semnalate. |
Câmpurile răspunsului — în interiorul obiectului data din plicul răspunsului. [] marchează o listă, deci data.items[].name este câmpul name al fiecărui element. Un câmp este null, lipsește sau este o listă goală atunci când nu avem o valoare — niciodată un substitut.
| Câmp | Descriere |
|---|---|
data.shifts[] | Pe tură: 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) sau weekend (country, date, day). |
data.violations[] | Fiecare încălcare EU 561 / AETR / 2002/15 a planului, în formatul din validate. |
data.remaining_after_plan | Bugetele de conducere și următoarele odihne după ultima tură planificată (validate remaining.driving). |
data.summary | shift_count, shifts_flagged, shifts_moved, violation_count, ban_windows_considered, countries, ruleset, crew. |
data.warnings[] | de ex. shift_layout_overflows, holidays_unavailable; data.assumptions[] indică modul în care au fost interpretate datele lipsă. |
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"
}
]
}'
Actualizat