Import Installation Jobs⚓︎

Quickly create 10, 100, or up to 1,000 installation jobs simultaneously by uploading a CSV file.

What You’ll Need⚓︎

Required: A CSV file with at least one field populated per row. Technically, any field works, even just a list of fuel types.

Strongly recommended: Include at least one vehicle identifier per row:

License plate (license_plate)
VIN (vin)
Custom name (custom_name)

Optional: Create a template beforehand to apply consistent master data and feature configurations across all imported jobs.

Quick Example⚓︎

Here’s what a simple CSV looks like:

license_plate,vin,vehicle_model_id
DE MO 1701,WBADT43452G297186,01JQ8JJCPKT5CGQSCJGADTP7ZY
DE MO 1702,WBADT43452G297187,01JQ8JJCPKT5CGQSCJGADTP7ZY
TE ST 1703,WBADT43452G297188,01JQ8JJCPKT5CGQSCJGADTP7ZY

That’s it! Three vehicles, ready to import. See more examples below.

Quick Start⚓︎

Go to Fleet → Installer Jobs → New Job → Import.
Click Select CSV File and choose your file.
Optional: Select a template from the dropdown.
- If the system detects conflicting data, you can choose “Prefer template data” to override your CSV values.
Optional: Assign an installer company (this option is disabled if your CSV already includes an assigned_installer_company_id).
Click Import Installation Jobs to finish.

Your jobs will appear in the Installation Jobs table, ready to be assigned or worked on by your service partner’s technicians.

Bulk Assign

Need to assign installer companies to multiple jobs at once? Select them in the Installation Jobs table and click Bulk Assign.

After Import⚓︎

Jobs are automatically set to ASSIGNED status when:

Your CSV includes assigned_installer_company_id, or
You select an installer company in the import dialog

To assign jobs later: Select unassigned jobs → Bulk Assign → Choose partner → Submit.

File Format⚓︎

license_plate,vin,vehicle_model_id,installation_variant,central_lock_connection_type,fuel_type,instructions
XYZ-123,WBADT43452G297186,01JQ8JJCPKT5CGQSCJGADTP7ZY,CAN_INSTALLATION,DIRECT,ELECTRIC,"Take pictures after installation."

Requirements:

Delimiter: Comma (,)
Encoding: UTF-8
Headers: Field names in first row
Text with commas: Wrap in quotes "Text, here"
Case-sensitive: CAN_INSTALLATION not can_installation

Available Fields⚓︎

Model-Dependent Fields

installation_variant and central_lock_connection_type can only be set when vehicle_model_id is present.

Field	Format	Max Length	Notes
`license_plate`	Text	70 chars	Must be unique in fleet.
`vin`	Text	17 chars	Must be unique in fleet.
`vehicle_model_id`	Text	40 chars	Copy from Vehicle Models.
`installation_variant`	`CAN_INSTALLATION` \| `OBD2_INSTALLATION`	—	Requires `vehicle_model_id`. Must be supported by the selected model.
`central_lock_connection_type`	`DIRECT` \| `LOMO` \| `PID_LOMO` \| `CAN_PID_LOMO` \| `SKM`	—	Requires `vehicle_model_id`. Depends on model + installation variant.
`fuel_type`	`GASOLINE` \| `DIESEL` \| `HYBRID` \| `ELECTRIC` \| `LPG` \| `HYDROGEN` \| `UNKNOWN`	—	—
`vehicle_type`	`CAR` \| `VAN` \| `TRUCK` \| `DEV_KIT` \| `DOOR_OPENER` \| `BUS` \| `MOTORCYCLE` \| `MOPED` \| `SCOOTER` \| `BIKE` \| `KICKSCOOTER`	—	—
`transmission`	`AUTOMATIC` \| `MANUAL_SHIFT`	—	—
`brand`	Text	70 chars	Auto-filled from vehicle model if not provided.
`model`	Text	70 chars	Auto-filled from vehicle model if not provided.
`custom_name`	Text	70 chars
`year_of_production`	Text	20 chars	“2025”
`instructions`	Text	500 chars	Special notes for installers.
`assigned_installer_company_id`	Text	12 chars	Copy in Manage Companies Dialog.

Examples⚓︎

Example 1⚓︎

Perfect for bulk-adding vehicles of the same type:

license_plate,vin,vehicle_model_id
DE MO 1701,WBADT43452G297186,01JQ8JJCPKT5CGQSCJGADTP7ZY
DE MO 1702,WBADT43452G297187,01JQ8JJCPKT5CGQSCJGADTP7ZY
TE ST 1703,WBADT43452G297188,01JQ8JJCPKT5CGQSCJGADTP7ZY

Example 2⚓︎

Include installation specifics for different vehicle types:

license_plate,vin,vehicle_model_id,installation_variant,central_lock_connection_type,fuel_type,year_of_production
FORD-001,WBADT43452G297186,01JQ8JJCPKT5CGQSCJGADTP7ZY,OBD2_INSTALLATION,SKM,ELECTRIC,2022
SUZUKI-002,WBADT43452G297187,01GG9PCDT6BSZZ1Y5QG0J20EDZ,CAN_INSTALLATION,DIRECT,DIESEL,2021
AUDI-003,WBADT43452G297188,01K33NRC2EQ25NWNV8GQQ5487S,CAN_INSTALLATION,PID_LOMO,GASOLINE,2023

Example 3⚓︎

Maximum detail including installer assignment and instructions:

license_plate,vin,vehicle_model_id,installation_variant,central_lock_connection_type,fuel_type,vehicle_type,year_of_production,custom_name,instructions,assigned_installer_company_id
DE MO 1701,WBADT43452G297186,01JQ8JJCPKT5CGQSCJGADTP7ZY,OBD2_INSTALLATION,SKM,DIESEL,CAR,2024,,Document setup via photos,2RSDF
DE MO 1702,WBADT43452G297187,01JQ8JJCPKT5CGQSCJGADTP7ZY,OBD2_INSTALLATION,SKM,GASOLINE,CAR,2024,,Document setup via photos,2RSDF
TE ST 1703,WBADT43452G297188,01JQ8JJCPKT5CGQSCJGADTP7ZY,OBD2_INSTALLATION,SKM,ELECTRIC,CAR,2022,,Document setup via photos,2RSDF

Templates⚓︎

Templates let you apply consistent settings to all imported jobs, including:

Master data: Vehicle brand, model, fuel type, year of production, vehicle type, transmission
Feature configurations: Auto Immo Control, Driving Events, Damage Detection, and more

To create a template:

Go to Fleet → Installer Jobs → Templates → New Template.
Configure master data fields and feature settings.
Save the template.

To use during import:

Select the template from the dropdown in the import dialog.
If your CSV and template have conflicting data (same field, different values), you’ll see the option “Prefer template data”.
Check it to let template values override CSV values, or leave unchecked to let CSV values win.

Priority Rules⚓︎

When conflicts exist (same field has different values in CSV and template):

“Prefer template data” checked: Template value is used.
“Prefer template data” unchecked (default): CSV value is used.

When no conflicts exist:

CSV values are used where present.
Template values fill in missing fields.
Fields not in either remain empty for the installer to fill in.

Example

Your template has fuel_type: DIESEL and CSV row has fuel_type: ELECTRIC:

The “Prefer template data” option becomes available
✓ Checked → Job gets DIESEL
☐ Unchecked → Job gets ELECTRIC

How CSV and Template Data Work Together

When conflicts exist (same field, different values):

The “Prefer template data” option appears in the import dialog.
Checked: Template values override CSV values.
Unchecked (default): CSV values override template values.

When no conflicts exist:

CSV values are used where present.
Template values fill in missing fields.
Fields not in either remain empty for the installer to complete.

About empty fields: While experienced installers can use their expertise to make correct decisions, inexperienced technicians may fill in incorrect data, leading to setup issues or installation failures.

Best practice: Provide as much data as possible in your CSV or template to minimize installer decisions and ensure consistent, correct installations.

Validation Rules⚓︎

Uniqueness

License plate must be unique within your fleet.
VIN must be unique within your fleet.

Format

Text fields are checked against length limits.
Enum values are case-sensitive (e.g., CAN_INSTALLATION not can_installation).
VIN follows standard vehicle identification patterns.

Logic

Vehicle model must exist in your fleet and be accessible.
installation_variant and central_lock_connection_type must not be set unless vehicle_model_id is present in the same row.
Installation variant must be supported by the vehicle model.
Central lock connection type must be compatible with model and variant.
Installer company must have ACCEPTED status with your fleet.

When validation fails, FleetControl shows which row caused the error and why. Correct the errors in your CSV file and import again.