Data Act

Technický formát exportu dat

Aktuální veřejný popis struktur, formátů a standardního rozhraní pro převzetí zákaznického exportu. Nejde o evidenci žádostí ani veřejný přístup k zákaznickým datům.

Verze formátu: 1.2

Předání a základ balíčku

  • Žádost se podává e-mailem podle přílohy A zpracovatelské smlouvy.
  • Zákazníkovi je ZIP dostupný po přihlášení přes časově omezený podepsaný HTTPS odkaz a současně přes níže popsané rozhraní pouze pro čtení.
  • Na doložený pokyn zákazníka dostane výslovně pověřený cílový poskytovatel vlastní časově omezený odkaz a kód mimo URL. Zákazník i cílový poskytovatel mají ve stejné době a ve stejném rozsahu přístup ke stejnému rozhraní a konkrétnímu ZIP; přístup neposkytuje účet ani jinou část Flotilo.
  • Každá strukturovaná sada je současně v UTF-8 CSV a UTF-8 JSON Lines. Datum a čas se serializují podle níže uvedeného schématu, datum-čas vždy v UTC s výslovným offsetem.
  • manifest.json uvádí počty a SHA-256, schema.json strojově popisuje typy, null hodnoty a vztahy a files-manifest.json dostupnost původních souborů.
  • Původní zákaznické soubory jsou v adresáři files/; aktivní tokeny, přihlašovací prostředky a interní identifikátory poskytovatelů se neexportují.

Otevřené strojové rozhraní

Rozhraní používá HTTPS GET a přístupový kód v hlavičce Authorization: Bearer …; kód se neposílá v URL. Úplný veřejný popis je dostupný jako OpenAPI 3.1 a přesné schéma balíčku jako JSON schéma exportu. Oba dokumenty jsou veřejné, neobsahují přístupové kódy ani zákaznická data.

datasets/company.csv + .jsonl

Firemní profil a nastavení

SloupecJSONL typ / formátNullVztah
id integer ne —
name string ne —
home_base_name string ano —
home_base_lat string / decimal ano —
home_base_lng string / decimal ano —
fuel_price_per_l string / decimal ano —
fuel_consumption_per_100km string / decimal ano —
rate_per_km string / decimal ano —
billing_name string ano —
billing_email string ano —
billing_street string ano —
billing_city string ano —
billing_postal_code string ano —
billing_country string ano —
company_identification_number string ano —
vat_id string ano —
billing_details_confirmed_at string / date-time ano —
created_at string / date-time ano —
updated_at string / date-time ano —
datasets/users.csv + .jsonl

Uživatelé, role a provozní režim

SloupecJSONL typ / formátNullVztah
id integer ne —
company_id integer ano company.id
name string ne —
email string ne —
email_verified_at string / date-time ano —
role string ne —
active boolean ne —
is_admin boolean ne —
operational_view_mode string ne —
created_at string / date-time ano —
updated_at string / date-time ano —
datasets/vehicles.csv + .jsonl

Vozidla

SloupecJSONL typ / formátNullVztah
id integer ne —
company_id integer ne company.id
name string ne —
plate string ne —
status string ne —
driver_id integer ano users.id
home_base_name string ano —
home_base_lat string / decimal ano —
home_base_lng string / decimal ano —
depot_lock_date string / date ano —
tracking_active boolean ne —
tracking_started_at string / date-time ano —
fuel_price_per_l string / decimal ano —
fuel_consumption_per_100km string / decimal ano —
rate_per_km string / decimal ano —
stk_expires_at string / date ano —
insurance_expires_at string / date ano —
hazard_insurance_expires_at string / date ano —
highway_sticker_expires_at string / date ano —
tachograph_calibration_expires_at string / date ano —
created_at string / date-time ano —
updated_at string / date-time ano —
datasets/vehicle_profiles.csv + .jsonl

Technické profily vozidel

SloupecJSONL typ / formátNullVztah
id integer ne —
company_id integer ne company.id
vehicle_id integer ne vehicles.id
height_m string / decimal ne —
weight_t string / decimal ne —
length_m string / decimal ne —
width_m string / decimal ne —
hazmat boolean ne —
cargo_length_m string / decimal ne —
cargo_width_m string / decimal ne —
cargo_height_m string / decimal ne —
created_at string / date-time ano —
updated_at string / date-time ano —
datasets/operational_driver_assignments.csv + .jsonl

Provozní přiřazení řidičů

SloupecJSONL typ / formátNullVztah
id integer ne —
company_id integer ne company.id
viewer_user_id integer ne users.id
driver_user_id integer ne users.id
created_at string / date-time ano —
updated_at string / date-time ano —
datasets/operational_emergency_recipients.csv + .jsonl

Příjemci nouzových provozních událostí

SloupecJSONL typ / formátNullVztah
id integer ne —
company_id integer ne users.company_id
vehicle_tracking_event_id integer ne vehicle_tracking_events.id
user_id integer ne users.id
delivery_tier string ne —
authorized_at string / date-time ne —
created_at string / date-time ano —
updated_at string / date-time ano —
datasets/trips.csv + .jsonl

Jízdy

SloupecJSONL typ / formátNullVztah
id integer ne —
company_id integer ne company.id
name string ne —
origin string ne —
destination string ne —
planned_start string / date-time ne —
planned_end string / date-time ano —
status string ne —
note string ano —
vehicle_id integer ano vehicles.id
driver_id integer ano users.id
price string / decimal ano —
cost_per_km string / decimal ano —
total_km string / decimal ano —
loaded_km string / decimal ano —
empty_km string / decimal ano —
trip_template_id integer ano trip_templates.id
trip_template_recurrence_id integer ano trip_template_recurrences.id
template_occurrence_on string / date ano —
template_generated_at string / date-time ano —
created_at string / date-time ano —
updated_at string / date-time ano —
datasets/trip_stops.csv + .jsonl

Body trasy jízd

SloupecJSONL typ / formátNullVztah
id integer ne —
company_id integer ne company.id
trip_id integer ne trips.id
type string ne —
address string ne —
window_from string / date-time ano —
window_to string / date-time ano —
cargo_note string ano —
order integer ne —
lat string / decimal ano —
lng string / decimal ano —
address_raw string ano —
price string / decimal ano —
service_min integer ano —
stay_away_after boolean ne —
created_at string / date-time ano —
updated_at string / date-time ano —
datasets/trip_stop_cargo_items.csv + .jsonl

Náklad na bodech trasy

SloupecJSONL typ / formátNullVztah
id integer ne —
company_id integer ne company.id
trip_stop_id integer ne trip_stops.id
length_m string / decimal ne —
width_m string / decimal ne —
height_m string / decimal ne —
weight_t string / decimal ano —
quantity integer ne —
created_at string / date-time ano —
updated_at string / date-time ano —
datasets/trip_stop_events.csv + .jsonl

Události bodů trasy

SloupecJSONL typ / formátNullVztah
id integer ne —
company_id integer ne company.id
trip_id integer ne trips.id
trip_stop_id integer ne trip_stops.id
vehicle_id integer ne vehicles.id
event_type string ne —
occurred_at string / date-time ne —
expires_at string / date-time ano —
actor_user_id integer ano —
source string ne —
manual_reason string ano —
client_occurred_at string / date-time ano —
server_received_at string / date-time ano —
client_clock_skew_seconds integer ano —
created_at string / date-time ano —
updated_at string / date-time ano —
datasets/vehicle_last_positions.csv + .jsonl

Poslední polohy vozidel

SloupecJSONL typ / formátNullVztah
id integer ne —
company_id integer ne company.id
vehicle_id integer ne vehicles.id
lat string / decimal ne —
lng string / decimal ne —
speed_kmh string / decimal ano —
heading integer ano —
recorded_at string / date-time ne —
created_at string / date-time ano —
updated_at string / date-time ano —
datasets/vehicle_position_samples.csv + .jsonl

Historie poloh v aktuální retenci

SloupecJSONL typ / formátNullVztah
id integer ne —
company_id integer ne company.id
vehicle_id integer ne vehicles.id
lat string / decimal ne —
lng string / decimal ne —
speed_kmh string / decimal ano —
heading integer ano —
recorded_at string / date-time ne —
created_at string / date-time ano —
updated_at string / date-time ano —
datasets/vehicle_tracking_events.csv + .jsonl

Události trackingu

SloupecJSONL typ / formátNullVztah
id integer ne —
company_id integer ne company.id
vehicle_id integer ne vehicles.id
user_id integer ano users.id
event_type string ne —
reason string ano —
occurred_at string / date-time ne —
created_at string / date-time ano —
updated_at string / date-time ano —
datasets/trip_templates.csv + .jsonl

Šablony jízd

SloupecJSONL typ / formátNullVztah
id integer ne —
company_id integer ne company.id
name string ne —
route_summary string ano —
note string ano —
planned_start string / date-time ano —
planned_end string / date-time ano —
price string / decimal ano —
cost_per_km string / decimal ano —
total_km string / decimal ano —
loaded_km string / decimal ano —
empty_km string / decimal ano —
recommended_vehicle_id integer ano vehicles.id
archived_at string / date-time ano —
created_at string / date-time ano —
updated_at string / date-time ano —
datasets/trip_template_stops.csv + .jsonl

Body trasy šablon

SloupecJSONL typ / formátNullVztah
id integer ne —
company_id integer ne company.id
trip_template_id integer ne trip_templates.id
type string ne —
address string ne —
lat string / decimal ano —
lng string / decimal ano —
address_raw string ano —
window_from string / date-time ano —
window_to string / date-time ano —
service_min integer ano —
cargo_note string ano —
price string / decimal ano —
disallow_rotation boolean ne —
disallow_stacking boolean ne —
order integer ne —
stay_away_after boolean ne —
created_at string / date-time ano —
updated_at string / date-time ano —
datasets/trip_template_stop_cargo_items.csv + .jsonl

Náklad v šablonách

SloupecJSONL typ / formátNullVztah
id integer ne —
company_id integer ne company.id
trip_template_stop_id integer ne trip_template_stops.id
length_m string / decimal ne —
width_m string / decimal ne —
height_m string / decimal ne —
weight_t string / decimal ano —
quantity integer ne —
created_at string / date-time ano —
updated_at string / date-time ano —
datasets/trip_template_recurrences.csv + .jsonl

Opakování šablon

SloupecJSONL typ / formátNullVztah
id integer ne —
company_id integer ne company.id
trip_template_id integer ne trip_templates.id
frequency string ne —
interval integer ne —
weekly_days object-or-array / json ano —
monthly_mode string ano —
day_of_month integer ano —
week_of_month string ano —
weekday string ano —
starts_on string / date ne —
ends_on string / date ano —
skip_czech_holidays boolean ne —
last_generated_until string / date ano —
last_generated_at string / date-time ano —
created_at string / date-time ano —
updated_at string / date-time ano —
datasets/trip_template_recurrence_exceptions.csv + .jsonl

Výjimky opakování šablon

SloupecJSONL typ / formátNullVztah
id integer ne —
company_id integer ne company.id
trip_template_recurrence_id integer ne trip_template_recurrences.id
exception_on string / date ne —
created_at string / date-time ano —
updated_at string / date-time ano —
datasets/trip_documents.csv + .jsonl

Dokumenty jízd

SloupecJSONL typ / formátNullVztah
id integer ne —
company_id integer ne company.id
trip_id integer ne trips.id
user_id integer ano users.id
type string ne —
original_name string ano —
mime string ne —
size_bytes integer ano —
created_at string / date-time ano —
updated_at string / date-time ano —
export_file string / relative-path ano —
datasets/trip_stop_documents.csv + .jsonl

Dokumenty a fotografie bodů trasy

SloupecJSONL typ / formátNullVztah
id integer ne —
company_id integer ne company.id
trip_id integer ne trips.id
trip_stop_id integer ne trip_stops.id
user_id integer ano users.id
original_name string ano —
mime string ano —
size_bytes integer ano —
taken_at string / date-time ano —
photo_type string ano —
photo_slot integer ano —
created_at string / date-time ano —
updated_at string / date-time ano —
export_file string / relative-path ano —
datasets/tachograph_folders.csv + .jsonl

Složky tachografů

SloupecJSONL typ / formátNullVztah
id integer ne —
company_id integer ne company.id
name string ne —
created_at string / date-time ano —
updated_at string / date-time ano —
datasets/tachograph_uploads.csv + .jsonl

Nahrané tachografové soubory

SloupecJSONL typ / formátNullVztah
id integer ne —
company_id integer ne company.id
uploaded_by integer ano users.id
folder_id integer ano tachograph_folders.id
original_name string ne —
size_bytes integer ne —
file_type string ano —
status string ne —
card_number string ano —
vehicle_registration string ano —
driver_name string ano —
data_period_start string / date-time ano —
data_period_end string / date-time ano —
generation string ano —
has_signatures boolean ne —
warnings object-or-array / json ano —
analysis_metadata object-or-array / json ano —
card_expiry_date string / date ano —
created_at string / date-time ano —
updated_at string / date-time ano —
export_file string / relative-path ano —
datasets/tachograph_activities.csv + .jsonl

Aktivity tachografů

SloupecJSONL typ / formátNullVztah
id integer ne —
company_id integer ne company.id
upload_id integer ne tachograph_uploads.id
date string / date ne —
driver_name string ano —
card_number string ano —
vehicle_registration string ano —
activity_type string ne —
started_at string / date-time ne —
ended_at string / date-time ne —
duration_minutes integer ne —
source_metadata object-or-array / json ano —
created_at string / date-time ano —
updated_at string / date-time ano —
datasets/tachograph_daily_summaries.csv + .jsonl

Denní souhrny tachografů

SloupecJSONL typ / formátNullVztah
id integer ne —
company_id integer ne company.id
upload_id integer ne tachograph_uploads.id
date string / date ne —
driver_name string ano —
card_number string ano —
vehicle_registration string ano —
driving_minutes integer ne —
rest_minutes integer ne —
work_minutes integer ne —
availability_minutes integer ne —
distance_km string / decimal ano —
created_at string / date-time ano —
updated_at string / date-time ano —
datasets/tachograph_violations.csv + .jsonl

Vyhodnocená porušení z tachografů

SloupecJSONL typ / formátNullVztah
id integer ne —
company_id integer ne company.id
upload_id integer ne tachograph_uploads.id
date string / date ne —
driver_name string ano —
card_number string ano —
violation_type string ne —
severity string ne —
description string ne —
actual_value string ne —
legal_limit string ne —
created_at string / date-time ano —
updated_at string / date-time ano —
datasets/tachograph_events.csv + .jsonl

Události tachografů

SloupecJSONL typ / formátNullVztah
id integer ne —
company_id integer ne company.id
upload_id integer ne tachograph_uploads.id
event_type string ne —
occurred_at string / date-time ne —
vehicle_registration string ano —
description string ano —
created_at string / date-time ano —
updated_at string / date-time ano —
datasets/company_subscriptions.csv + .jsonl

Zákaznicky relevantní metadata předplatného

SloupecJSONL typ / formátNullVztah
id integer ne —
company_id integer ano company.id
status string ne —
trial_ends_at string / date-time ano —
current_period_start string / date-time ano —
current_period_end string / date-time ano —
cancel_at_period_end boolean ne —
grace_ends_at string / date-time ano —
billing_kind string ne —
individual_offer_id integer ano individual_plan_offers.id
catalog_quantity integer ano —
catalog_platform_price_czk_monthly integer ano —
catalog_vehicle_price_czk_monthly integer ano —
created_at string / date-time ano —
updated_at string / date-time ano —
datasets/individual_plan_offers.csv + .jsonl

Individuální nabídky

SloupecJSONL typ / formátNullVztah
id integer ne —
company_id integer ne company.id
status string ne —
name string ne —
vehicle_limit integer ne —
capacity_limit integer ano —
price_czk_monthly integer ne —
published_at string / date-time ano —
accepted_at string / date-time ano —
activated_at string / date-time ano —
expires_at string / date-time ano —
created_at string / date-time ano —
updated_at string / date-time ano —
datasets/subscription_change_requests.csv + .jsonl

Požadavky na změnu předplatného

SloupecJSONL typ / formátNullVztah
id integer ne —
company_id integer ne company.id
source_kind string ne —
target_kind string ne —
target_offer_id integer ano individual_plan_offers.id
timing string ne —
status string ne —
activate_at string / date-time ano —
confirmed_at string / date-time ano —
applied_at string / date-time ano —
target_catalog_quantity integer ano —
target_catalog_platform_price_czk_monthly integer ano —
target_catalog_vehicle_price_czk_monthly integer ano —
created_at string / date-time ano —
updated_at string / date-time ano —
datasets/legal_acceptances.csv + .jsonl

Evidence právních potvrzení

SloupecJSONL typ / formátNullVztah
id integer ne —
user_id integer ano users.id
company_id integer ano company.id
context string ne —
subject_role string ano —
subject_name string ano —
subject_email string ano —
company_name string ano —
accepted_documents object-or-array / json ne —
accepted_at string / date-time ne —
created_at string / date-time ano —
updated_at string / date-time ano —
datasets/trip_public_links.csv + .jsonl

Metadata veřejných stavových odkazů

SloupecJSONL typ / formátNullVztah
id integer ne —
company_id integer ne company.id
trip_id integer ne trips.id
trip_stop_id integer ne trip_stops.id
created_by integer ano users.id
expires_at string / date-time ne —
revoked_at string / date-time ano —
last_accessed_at string / date-time ano —
created_at string / date-time ano —
updated_at string / date-time ano —

Omezení rozhraní

Standardní rozhraní poskytuje zdrojový balíček ke stažení. Nejde o databázový dump, anonymní odkaz, průběžnou synchronizaci ani import do cílové služby. Přesný smluvní rozsah, vyloučení a postup jsou uvedeny v příloze A DPA.