Cumplimiento de flota — Plan Check API Online
Comprueba turnos o días de viaje planificados antes del despacho. Envía los turnos y los países por los que circulan como cuerpo JSON de una petición POST; cada turno devuelve las prohibiciones de circulación de camiones que le afectan (prohibiciones de fin de semana, domingo, festivos y otras de nuestro calendario de prohibiciones para camiones, filtradas por peso del vehículo), los festivos y días de fin de semana que toca, las infracciones de EU 561 / AETR y 2002/15 que el plan causaría, y el inicio legal más temprano: tras el descanso diario o semanal requerido y fuera de toda prohibición bloqueante.
POST https://nakordoni.eu/api/v2/data/fleet/compliance/plan-check
— clase de cuota: heavy
| Parámetro | Descripción |
|---|---|
shifts | (cuerpo JSON, obligatorio, máx. 60, intervalo máx. 62 días) [{start, end, countries?, drive_min?, other_work_min?, activities?}]. Sin activities, el turno se organiza como otro trabajo, seguido de conducción en bloques de 4 h 30 con pausas de 45 min. Cada actividad: {type: drive | other_work | availability | break | rest, start, end} — ISO-8601 (un datetime sin offset se interpreta en tz) o segundos unix. Opcionales en los descansos: ferry (true en un ferri o tren), sleeper_cabin, scheduled_journey_h, in_vehicle, location (residence | operational_centre | elsewhere — comprobación de regreso cada 4 semanas según EU 561 Art. 8(8a)). Opcionales en las conducciones: art12_exceed (true = conducción por encima del límite según EU 561 Art. 12 para llegar al centro operativo o al domicilio para un descanso semanal). Los huecos entre actividades cuentan como descanso (se indican en warnings); los solapamientos se rechazan. |
countries | (cuerpo JSON) Códigos ISO de países usados para los turnos que no indican los suyos, p. ej. ["DE","AT"]. |
tz | (cuerpo JSON) Zona horaria IANA del plan (fechas y horas sin desfase), por defecto UTC. Las ventanas de prohibición usan la zona horaria propia de cada país. |
weight_t | (cuerpo JSON) Peso del vehículo en toneladas; se omiten las prohibiciones con un umbral de peso igual o superior. Omitido = se incluyen todas las prohibiciones. |
history | (cuerpo JSON) Actividades recientes anteriores al plan (formato como en validate) para que los descansos y presupuestos se trasladen. |
last_weekly_rest_end | (cuerpo JSON) Fin del último descanso semanal anterior al plan. |
ruleset | (cuerpo JSON) eu561 (por defecto) o aetr. crew single | double. international_goods, include_wtd, wtd como en validate. |
allow_reduced_daily_rest | (cuerpo JSON) true = las sugerencias pueden usar un descanso diario reducido de 9 h (por defecto: 11 h). |
allow_reduced_weekly_rest | (cuerpo JSON) true = las sugerencias pueden usar un descanso semanal reducido de 24 h (por defecto: 45 h). |
blocking_types | (cuerpo JSON) Tipos de prohibición que desplazan un inicio sugerido (por defecto Sunday, Saturday, Holiday, Holiday Eve, General; solo prohibiciones de ámbito nacional). Las demás se siguen señalando. |
Campos de la respuesta — dentro del objeto data del sobre de respuesta. [] indica una lista, así que data.items[].name es el campo name de cada elemento. Un campo es null, no aparece o es una lista vacía cuando no tenemos valor: nunca un marcador de posición.
| Campo | Descripción |
|---|---|
data.shifts[] | Por turno: 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) o weekend (country, date, day). |
data.violations[] | Cada infracción del plan de EU 561 / AETR / 2002/15, en el formato de validate. |
data.remaining_after_plan | Presupuestos de conducción y próximos descansos tras el último turno planificado (validate remaining.driving). |
data.summary | shift_count, shifts_flagged, shifts_moved, violation_count, ban_windows_considered, countries, ruleset, crew. |
data.warnings[] | p. ej. shift_layout_overflows, holidays_unavailable; data.assumptions[] indica cómo se interpretaron los datos que faltaban. |
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"
}
]
}'
Actualizado