TL Rates — CSV Upload

Sat, 19 Sep 2026 00:00:00 +0000

Truckload (TL) carrier contracts are typically priced on a per-mile basis — the freight cost for a shipment is calculated by multiplying the agreed rate per mile by the distance between the origin and destination. To do this, OTM needs to know the distance for every lane it plans.

OTM supports two approaches to sourcing distances:

Distance Lookup (manual upload): The business team maintains a table of pre-defined distances between city pairs or zip codes and uploads them into OTM. This is the approach covered in this topic — the DISTANCE_LOOKUP file in the upload sequence stores these values.
Third-party distance providers: OTM can integrate with mileage calculation applications such as PC*MILER or MileMaker. When a rate is configured to use one of these providers, OTM calls the external application at runtime to fetch the exact mileage rather than relying on a stored value.

Configuring a third-party distance provider (Rate Distance) is a separate setup topic that will be covered in a future post. The RATE_DISTANCE_GID field in the files below must reference whichever distance source your environment is using — either a lookup table or a third-party provider already configured in OTM.

OTM allows TL rate contracts to be loaded using CSV files instead of manual UI entry. This is the most efficient approach when setting up rates for multiple lanes or carriers.

TL Rates on Learn Oracle OTM

TL Rates — CSV Upload