Skip to main content
Before vendors can receive and manage delivery orders, an administrator must configure vendor teams, invite vendor users, and assign the correct permissions. This guide walks you through the complete setup process.
Required permission:
  • View Team, Create Team, Edit Team
  • View User, Invite User, Edit User
  • View Permission

Overview

The vendor configuration process follows these steps:
  1. Create Roles for vendor admin and vendor driver
  2. Set Permissions so vendors can only access what they need
  3. Create a Team for the vendor
  4. Invite Vendor Users (admin and drivers) and assign them to the vendor team
After completing these steps, the vendor admin can log in to Mile.app, access the Transport Vendor Management add-on, and start accepting orders.

Step 1: Create Vendor Roles

Go to Settings > Permission and click New to create two new roles:

ADMIN VENDOR Role

This role is for the vendor’s administrator who will accept/reject orders, assign drivers, and manage vehicles.

Task & User Permissions

Admin Vendor role - Task and User permissions

ADMIN VENDOR role showing Task permissions (View task with “Show only my task”, Create task, Assign task) and User permissions (View user, Invite user, Edit user).

Flow Permissions

Admin Vendor role - Flow permissions

Flow permissions: View flow, Create flow, Edit flow enabled.

Automation Permissions

Admin Vendor role - Automation permissions

Automation permissions: View automation, Create automation, Edit automation enabled.

Data & Data Type Permissions

Admin Vendor role - Data and Data Type permissions

Data permissions (View, Create, Edit data source) and Data Type permissions (View, Create, Edit, Delete data type) enabled.

Team Permissions

Admin Vendor role - Team permissions

Team permissions: View team, Create team, Edit team enabled.

Custom Module & Add-on Permissions

Admin Vendor role - Custom Module permissions

Custom Module: View custom module enabled (optional).

Admin Vendor role - Transport Vendor Management add-on permission

Custom section: View Transport Vendor Management must be enabled so the vendor admin can access the add-on.

ADMIN VENDOR Permission Summary

CategoryPermissions
TaskView task (with “Show only my task” enabled), Create task, Assign task
UserView user, Invite user, Edit user
FlowView flow, Create flow, Edit flow
AutomationView automation, Create automation, Edit automation
DataView data source, Create data, Edit data source
Data TypeView data type, Create data type, Edit data type, Delete data type
TeamView team, Create team, Edit team
Custom ModuleView custom module (optional)
Custom > Transport Vendor ManagementView Transport Vendor Management
The “Show only my task” option under View Task ensures vendor admins only see tasks belonging to their own team, not tasks from other vendors or the principal organization.

DRIVER VENDOR Role

This role is for the vendor’s drivers who will complete pickup and delivery tasks on the MileApp mobile app.
CategoryPermissions
TaskView task (with “Show only my task” enabled), Do task
Drivers only need minimal permissions since they will use the mobile app to complete assigned tasks.

Step 2: Create a Vendor Team

Go to Settings > Team and click New to create a team for the vendor.
Team management showing Team Vendor

The Team management page showing a vendor team with 2 users assigned.

Enter the team name (e.g., “Team Vendor”, “PT Express Logistics”, or the vendor’s company name) and save.
Each vendor should have their own dedicated team. Do not mix users from different vendor companies in the same team.

Step 3: Invite Vendor Users

Go to Settings > User and click Invite to add the vendor’s admin and driver users.

Invite Vendor Admin

  1. Enter the vendor admin’s email address
  2. Select the ADMIN VENDOR role
  3. Assign to the vendor team created in Step 2
  4. Click Invite

Invite Vendor Drivers

  1. Enter the driver’s email address
  2. Select the DRIVER VENDOR role
  3. Assign to the same vendor team as the admin
  4. Click Invite
Both the vendor admin and all vendor drivers must be in the same team. This ensures:
  • The admin can see and assign drivers from their team
  • Drivers only see tasks assigned to their team
  • Orders sent to the vendor team are visible to the admin
Repeat the driver invitation for each driver the vendor will use.

Step 4: Verify the Setup

After inviting all vendor users, verify the configuration:
  1. Go to Settings > Team and confirm the vendor team shows the correct number of users
  2. Go to Settings > User and verify each vendor user has the correct role and team assignment
  3. Ask the vendor admin to log in and verify they can see the Transport Vendor Management add-on

How It Works After Setup

Once configured, the workflow between principal and vendor works as follows:
ActorAction
Principal AdminCreates a delivery order and sends it to the vendor team
Vendor AdminOpens Transport Vendor Management, sees the order, clicks Accept, selects a driver and vehicle from their team
Vendor DriverReceives a pickup task on the MileApp mobile app, completes it
AutomationCreates a delivery task automatically and assigns it to the same driver
Vendor DriverCompletes the delivery task
AutomationMarks the order as completed

Adding More Vendors

To add another vendor, repeat the process:
  1. Create a new team for the new vendor
  2. Invite the new vendor’s admin with the ADMIN VENDOR role
  3. Invite the new vendor’s drivers with the DRIVER VENDOR role
  4. Assign all users to the new vendor’s team
Each vendor team operates independently — they can only see orders sent to their team and can only assign drivers from their own team.