Overview #

Driver import in the Driver Administration tab of the Drivewyze Hub enables you to make large or small updates to your fleet quickly by uploading a CSV file of drivers.

For example, you can change the usernames and passwords in the Drivewyze app for drivers if you use them in your implementation. You can also make bulk edits to details like Name and CDL.

Considerations #

• Drivewyze recommends importing less than 2000 drivers at a time. Attempting to import more than 2000 records in a single file may result in slow response time and increase the chances of failed import attempts.
• Drivers may not be able to be deleted in Drivewyze Hub depending on your partner integration.

Import Drivers #

1. Navigate to Admin > Drivers.

2. Click Import. A modal opens that displays all the items you can import
   Note: The items you can import depend on your Drivewyze partner integration.
   
   

3. Click the upload icon, then choose your file.
   
   

4. Click Upload and Continue.
   If the upload has no errors, click Import drivers.
   If the upload has errors, refer to the error referenced and fix your import file. Then try the upload again.
   

5. Click Import drivers.

6. Click Close to confirm the import.

Common Import errors #

Below is a list of the most common import errors that can occur during an import.

Incorrect permissions

You may not have permission to add drivers or make updates to certain details about drivers. To see what you are able to edit, check out the upload preview.

Duplicate drivers detected

If duplicate drivers are detected, go back into your upload file and make adjustments to remove the duplicates.

Validation issues

This might be due to a poorly formatted phone number, email address or username. Ensure phone numbers contain only numbers and valid characters like “+”, “-“, and “()”. Avoid using any letters, as they are not allowed. Usernames must include letters and cannot be only numbers. For example, “john123” or an email address like “john@example.com” is fine, but “123456” is not allowed.

User distinctness

Each username across all Drivewyze customers must be unique. If a user already exists with the chosen username and does exist in your fleet, it will not be updated. Contact support to adjust the accounts if required.

Password strength

If the password selected does not meet the minimum requirements for user passwords in Drivewyze, the user will not be updated. Download the error file to see a detailed message on the password strength requirement. Drivers must have a Username in order to set a Password.

Expected column not found

The import process looks for correctly named columns. If an expected column is not found during import, go back into your upload file and verify that all columns are where they should be. You can download the template file to compare with your upload file.

Import File Fields #

Below is the full field list for the driver import. Note: If you are missing some fields they are not available in your partner integration.