Configure distance providers (PC Miler and MileMaker)

Once your tenant is integrated with a distance provider, users with Admin-level permissions and above can configure and save your distance provider parameters within shipments, orders, customer accounts, and contracts. 

How distance provider rules work

Enabling distance provider parameters will override Turvo’s default mileage calculator and enable your distance provider, either PC Miler or MileMaker, as the mileage calculator for applicable shipments. If you do not input parameters, the distance provider will default to the Turvo mileage calculator. 

Your preferred distance provider configuration can be done at the shipment-level, order-level, customer account-level, or contract-level. 

  • Shipment-level configurations are used when calculating distance for all shipments that the configuration applies to. 
  • Order-level configurations are applied to all orders that the configuration applies to.
  • Customer account-level configurations are applied to contracts for all of that customer’s shipments that match the configuration’s mode. 
    • Customer account-level configurations can be inherited on to a contract. When inherited, Turvo uses the configured distance provider to calculate distance which is used for rating. Actual distance on the shipment or order remains the same. 
  • Contract-level configurations are specific to fuel, services, and accessorials on that contract. 

Note: If the rules for one level match the one above it, then no recalculation is done.

How it impacts shipment information

Using an external distance provider can impact your shipment information in the following ways.

Sharing with partner tenants

Sharing of distance along with distance provider depends on the Applicable for setting, which has two values: Owned shipments and All shipments.

For example, you have PC Miler enabled as your distance provider and you work with two customers, Customer 1 and Customer 2.

  • Customer 1 uses MileMaker for TL shipments with Applicable for set to All shipments. If you create a shipment and share it with Customer 1, the distance gets recalculated based on MileMaker.
  • Customer 2 uses MileMaker for TL shipments with Applicable for set to Owned Shipments. If you create a shipment and share it with Customer 1, the distance is not recalculated with MileMaker. 
  • If a shipment on an owned tenant is different from a shared tenant, then the distance is always recalculated based on the shared tenant’s configuration. For example, you have a shipment with four stops, Customer 1 has two stops and Customer 2 has two stops. The distance is recalculated using MileMaker for each shared tenant. 

Updating shipments

If a shipment is updated in such a way that it falls under a different distance provider rule than it did before, then Turvo will recalculate the distance and update the shipment.

Impact on ETAs and drive time

ETAs are calculated based on the distance provider configured. 

How to integrate a distance provider with your tenant

Users with Owner, Admin, or Super Admin roles in your tenant, can configure an external distance provider for shipments. 

  1. From anywhere in Turvo, click your profile icon in the top right corner and select Admin console from the drop-down.


  2. Click the Settings card to open the tenant setting.
    2_-_Admin_console_tiles.png

  3. Click the Shipments section header, then click Distance Providers.


  4. Toggle ON PCMiler or MileMaker:
    1. PCMiler: enter the API Key
    2. MileMaker: enter the username and password

  5. Use the Mode drop-down to select the mode.


    Note: The PC Miler integration is available for the TL, LTL, and Drayage modes only. All other modes must use Turvo’s default distance provider.

  6. Use the Provider drop-down to select from Turvo, PC Miler, and MileMaker.


  7. Use the Applicable for drop-down to select from All shipments and Owned shipments.


    Owned shipments: The selected distance provider will only be used for the shipments created within your tenant that match the selected mode.

    All shipments: The selected distance provider will be used for shipments that match the selected mode, whether they are created within your tenant or shared to your tenant by a shipping provider.

    Note: If the shipment is shared to your tenant and the original tenant uses a different distance provider than yours, then the distance is recalculated for your tenant.

  8. Use the Profile drop-down to either select a profile or to create one.


  9. To create a profile, click + Add profile.


  10. Complete the fields in the Add profile modal.


    Note: The options between PC Miler and MileMaker will vary based on version.

  11. Now that you have created a profile, it is available in the Profile drop-down. Select the profile and click Save to save your updates.

Once applied, the selected distance provider will calculate distance based on the parameters set for each mode’s rule. If a shipment is created that a rule does not apply to, that shipment will use the default Turvo distance provider.

How to configure customer order-level distance provider rules

To configure the distance provider on the order, follow the steps below:

  1. Navigate to Admin console > Settings > Orders and click Distance provider.

  2. Select PC Miler from the Provider drop-down.

  3. Select from the options under the Applicable for drop-down.

  4. Select the profile under the Profile drop-down. If no profiles are set up, click + Add profile.

  5. In the Add profile window, name your profile and then use the fields to set up your profile and click Save to save your changes.
    Note: The options between PC Miler and MileMaker will vary based on version.

  6. Now that you have created a profile, it is available in the Profile drop-down. Select the profile and click Save to save your updates. 

How to configure customer account-level distance provider rules

You can also configure a specific distance provider for a specific customer. These configurations are only applied to shipments for that customer that utilize contracted lane rates. Shipments that are not rated via lane rates for that customer will use the tenant-level settings.

To configure the distance provider on the customer account, follow the steps below:

  1. Navigate to Customer account > Details > Settings and click Distance provider.

  2. Select the mode from the Mode drop-down.

  3. Select PC Miler from the Provider drop-down.

  4. Select the profile under the Profile drop-down. If no profiles are set up, click + Add profile.

  5. In the Add profile window, name your profile and then use the fields to set up your profile and click Save to save your changes.
    Note: The options between PC Miler and MileMaker will vary based on version.

  6. Now that you have created a profile, it is available in the Profile drop-down. Select the profile and click Save to save your updates. 

These customer account-level rules will now be utilized to calculate routes for contracted lane rates on this customer’s shipments.

Updating the distance provider for contract cost types - freight, fuel, and accessorials

To configure the distance provider on the contract, follow the steps below:

  1. Navigate to Contract > Details and click Distance provider.

  2. Select from the options under the Cost Categories drop-down.
    • Note: You can multiselect from freight, fuel, and services.
  3. Select the mode from the Mode drop-down.

  4. Select PC Miler from the Provider drop-down.

  5. Select the profile under the Profile drop-down. If no profiles are set up, click + Add profile.

  6. In the Add profile window, name your profile and then use the fields to set up your profile and click Save to save your changes.
    Note: The options between PC Miler and MileMaker will vary based on version.

  7. Now that you have created a profile, it is available in the Profile drop-down. Select the profile and click Save to save your updates





Was this article helpful?

0 out of 0 found this helpful