Conformità della flotta — Validate API Online
Verifica l'attività registrata di un conducente rispetto alle norme su guida e riposo del Regolamento EU 561/2006 (o AETR) e all'orario di lavoro della Direttiva 2002/15/EC. Invia la cronologia come corpo POST JSON (JSON body): il turno corrente più fino a 28 giorni o più di storico simile al tachigrafo. Otterrai ogni violazione con l'articolo della norma, il timestamp e la gravità (fasce del Regolamento (UE) 2016/403), gli avvisi e ciò che resta al conducente in questo momento: guida giornaliera, budget settimanale di 56 h e bisettimanale di 90 h, quando sono dovuti la prossima pausa, il riposo giornaliero e il riposo settimanale, i giorni estesi e i riposi ridotti utilizzati e l'eventuale compensazione del riposo settimanale ridotto dovuta con la relativa scadenza. Copre le pause di 4 h 30 (incl. la suddivisione 15 + 30), le giornate di 9/10 h, il riposo giornaliero di 11/9 h e 3 + 9 h, i sei periodi di 24 ore tra i riposi settimanali, le sequenze di riposo settimanale ridotto e la compensazione, l'equipaggio doppio (riposo di 9 h entro 30 h), il riposo interrotto da traghetto/treno, e per la 2002/15 la media di 48 h, la settimana di 60 h, le pause dopo 6 h e il limite di 10 h di lavoro notturno. Dalla v1.1: l'eccezione dell'Art. 12 (fino a 1 h, o 2 h dopo una pausa di 30 min, oltre i limiti giornalieri e settimanali per raggiungere il centro operativo o la residenza per un riposo settimanale) con la compensazione dovuta e la sua scadenza, il rientro alla base o a casa ogni 4 settimane dell'Art. 8(8a), la deroga di 12 giorni dell'Art. 8(6a) per i servizi internazionali occasionali di autobus, e le fasce notturne nazionali della 2002/15 per paese. route_plan_state può essere passato direttamente a route-plan.
POST https://nakordoni.eu/api/v2/data/fleet/compliance/validate
— classe di quota: heavy
| Parametro | Descrizione |
|---|---|
activities | (corpo JSON, obbligatorio) Attività del conducente, dalla più vecchia o in qualsiasi ordine. Ogni attività: {type: drive | other_work | availability | break | rest, start, end} — ISO-8601 (un datetime senza offset viene interpretato in tz) oppure secondi unix. Facoltativi per i rest: ferry (true su un traghetto o un treno), sleeper_cabin, scheduled_journey_h, in_vehicle, location (residence | operational_centre | elsewhere — verifica del ritorno ogni 4 settimane ai sensi dell'EU 561 Art. 8(8a)). Facoltativo per i drive: art12_exceed (true = guida oltre il limite ai sensi dell'EU 561 Art. 12 per raggiungere il centro operativo o la propria abitazione per un riposo settimanale). Gli intervalli tra le attività contano come riposo (segnalati in warnings); le sovrapposizioni vengono rifiutate. |
history | (corpo JSON) Attività precedenti nello stesso formato (es. gli ultimi 28 giorni dal tachigrafo); unite a activities. |
tz | (corpo JSON) Fuso orario IANA per le settimane di calendario (lunedì 00:00) e la finestra notturna, predefinito UTC. |
ruleset | (corpo JSON) eu561 (predefinito) o aetr. limits elenca le differenze AETR che vengono applicate. |
crew | (corpo JSON) single (predefinito) o double (equipaggio multiplo). |
now | (corpo JSON) Momento di valutazione, predefinito la fine dell'ultima attività; il tempo dopo l'ultima attività conta come riposo. |
last_weekly_rest_end | (corpo JSON) Fine dell'ultimo riposo settimanale prima della timeline, quando la timeline non lo contiene. |
international_goods | (corpo JSON, eu561) true = il conducente effettua trasporto internazionale di merci fuori dallo Stato membro di stabilimento (due riposi settimanali ridotti consecutivi consentiti ai sensi dell'Art. 8(6)). |
passenger_12day | (corpo JSON) true oppure {abroad_24h: bool} = singolo servizio internazionale occasionale di trasporto passeggeri: il riposo settimanale può essere posticipato fino a dodici periodi di 24 ore dopo un riposo settimanale regolare (EU 561 Art. 8(6a), AETR Art. 8(6)(b)); vengono verificati i riposi successivi e la guida notturna (22:00-06:00: equipaggio multiplo o un periodo di guida di 3 h). |
country | (corpo JSON) Codice paese ISO per la fascia notturna nazionale della 2002/15 (identico a wtd.country). |
include_wtd | (corpo JSON) false = salta i controlli della Direttiva 2002/15/CE (predefinito true). |
wtd | (corpo JSON) Opzioni 2002/15: reference_weeks 1-52 (predefinito 17), reference_mode rolling | fixed, reference_start, night_window HH:MM-HH:MM (predefinito 00:00-04:00), country (codice ISO UE/SEE: fascia notturna nazionale, vedi limiti), carriage goods | passengers. |
Campi della risposta — all’interno dell’oggetto data della busta. [] indica una lista, quindi data.items[].name è il campo name di ogni elemento. Un campo è null, assente o una lista vuota quando non abbiamo un valore — mai un segnaposto.
| Campo | Descrizione |
|---|---|
data.compliant | true quando non è stata trovata alcuna violazione; violation_count e by_severity (most_serious, very_serious, serious, minor) le conteggiano. |
data.violations[] | code, ref (articolo della norma, es. "EU 561/2006 Art. 7"), severity, at (quando il limite è stato superato), value_min / limit_min / excess_min, period_start o week_start, open (ancora in corso al momento della valutazione), message. Le voci 2002/15 riportano banded=false. |
data.warnings[] | Elementi su cui intervenire che non sono ancora violazioni: code, message, ref e at opzionali (es. 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 (il più piccolo tra i budget giornaliero, settimanale e bisettimanale), 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 | Stato del conducente nei nomi dei parametri di 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[] | Ogni periodo di servizio tra riposi giornalieri/settimanali: start, end, drive_min, extended, rest_type, rest_start, rest_end, rest_min (+ ferry_interruptions). |
data.weekly_rests[] | Riposi settimanali rilevati: start, end, duration_min, type regular | reduced, periods_since_previous, compensation_owed_min, derogation. |
data.weeks | Per settimana di calendario: driving.drive_min e working_time.work_min, con complete. |
data.rolling | Solo informativo: la massima guida in qualsiasi finestra di 168 h e 336 h (il test legale usa le settimane di calendario). |
data.assumptions[] | Come è stato interpretato l'input incompleto (es. nessun riposo settimanale prima della timeline noto). |
data.exceptions | art12[]: ogni utilizzo dell'eccezione di 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 | La posizione inviata per quel riposo (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 (fonte nazionale). |
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"
}
]
}'
Aggiornato