How to Create Manual Tariffs

The purpose of this article is to describe the process of adding manual tariffs to the TMS. This is used when a direct API integration with the carrier is unavailable.


Tai handles API integrations with most national LTL carriers and a few Truckload carriers. However, in cases where a broker has contracted rates with a carrier not currently supported, a manual tariff can be created to allow those rates to populate through the normal shipment creation workflow as well.

To see a full list of supported carriers, refer to API /EDI Supported Carriers.

If Tai supports the carrier, the tariff can be created through the Tariff Wizard.

Manual tariffs can be added for all of our supported shipment types (LTL, Truckload, Drayage, White Glove, etc.), and the user will need the following staff permissions to create them:

  • Tariff Add Edit
  • User Allowed Org Access

It's important to note that Tai's manual tariffs are, in reality, "Buy" tariffs, in that only the buy amount will be calculated using the rates provided. The sell will then be calculated based on the buy plus the margin at the customer level. There's a workaround to create a "Sell" tariff, which will also be described in this article. 

Note: The lanes will be created based on the origin and destination zip codes or states, not cities.

Tariff Profile

To create the tariff profile, go to the main dashboard and click Rates > Tariffs > Add New Tariff.

  • Name: Even though the name will be built automatically, enter a preliminary name to be able to save the tariff. If the tariff is blanket for all customers, the name will start with a "BL," and if the tariff is customer specific, it will start with a "CS." it will be followed by the name of the customer or the name of the organization, and the SCAC of the carrier. 
  • Carrier: Enter the carrier for which the tariff is for. You can look for MC, DOT, SCAC, or name. If a "Sell" tariff is needed, the broker may have to create a dummy carrier to assign it to the tariff. 
  • Mode: Select the mode for which the tariff is for. 
  • Effective Date/Expiration date: The system will default the effective date to today and the expiration date for 20 years. 
  • Service level: Defaults to 'Normal' if nothing is selected. 
  • Status: Whether the tariff is visible to the users and customers. 
  • Pricing Instructions: These will show up, along with the rate under the Generate Smart Quote section. 
  • Source Name: For manual tariffs, this field will remain empty unless you are needing to utilize SMC/CzarLite base pricing. This is used when the tariff will be connected to an integration source. 
  • Tariff Owner: Typically, it will be the accounting organization or the parent account. It would be the company in charge of paying the carrier. 
    • Check the "Customer Specific" box if it needs to be linked to a particular customer. A tariff link will need to be added as well to complete this. 
  • Bill To Type: 1st or 3rd party collect and prepaid are the options. 
  • Bill To Address & Account Number: These will populate on the BOL and default to the tariff owner's organization address. 
  • Tariff Settings: Select if the tariff will be available for the front office, the rate requirements, and the lane's initial points. These can then be modified and adjusted on the tariff lane. For testing purposes, uncheck the Display In Front Office setting until the tariff is working properly and check the "All US Points" option. 

Once the tariff is created, the system will create a tariff profile with the lanes selected in the previous section. At the top, the user will find the following features:

  • Activity Log: Record all the changes made to the tariff. 
  • Accessorials: Tariff and lane. This process will be described throughout this article. 
  • Tariff Tools: This section is used to upload the tariff template with the date on it, add the tariff links to make the tariff customer-specific, add margins to the tariff and/or accessorials, and modify the tariff BOL. 
  • Import/Export CSV: Feature to export or import the tariff lanes.  

For a detailed explanation of tariff profiles, go to Tariff Profile

Tariff Lane

At the bottom of the tariff profile, the user can find the existing lanes and how to edit them, the option to add a new lane, and the ability to test a particular lane using the origin and destination zip codes:

To add a new lane, click the green Add Lane button. Click the edit pencil next to the lane information to edit an existing one. Once editing the lane, the user will see the following fields:

  • Origin and Destination Region: These will need to be created through the tariff template.
  • Transit SCAC: Typically, the carrier SCAC will be populated in this field. If need be, enter the SCAC of the carrier that should be handling that lane. 
  • Service Type: The system will use the SCAC to hit CarrierConnect and determine if the carrier services that lane through a direct or an indirect connection. For manual tariffs, select "All" to avoid errors from CarrierConnect.
  • Transit Time: If available, enter the transit time days. If not, leave in 0. 
  • Priority: If the same lane is duplicated in the system with different lane criteria, the priority will determine which lane will provide the rate. 
  • FAK: It stands for “Freight of All Kinds.” It’s a pricing method used during negotiation with carriers that groups freight class ranges so that they are billed or rated at the same class.
  • Lane Criteria: The user can select and specify the criteria needed for the lane to provide a rate, including mileage, weight, class, and so on. 
  • Lane Calculation Type: Describes how the rate is going to be calculated, based on CWT, mileage, pieces, flat amount, etc. 
  • Lane Upcharge Type: Describes if the rate will be marked up based on the same criteria as the calculation type. 
  • Lane notes: Optional internal comments. 

Tariff Template

To download the current template on a tariff, open the tariff profile and click Import/Export CSV > Export Tariff. The file will be downloaded with the tariff name. It's an Excel book with three sheets. 

  1. Regions: It's the section where the user can specify the origin and destination points.   
    • Region Name: it has to be as unique as possible to avoid duplicate zip codes for origin and/or destination. 
    • Region Type: The user can select from State, Postal Code, Postal Code Range, or Country. These options have a number assigned, which can be found on the cheat sheet attached to this article. 
    • The user can then enter all the states, zip codes, or zip code ranges that correspond to each region's name. 
  2. FAKs: Section where the class negotiation with the carrier and/or customer can be determined. 
    • FAK Name: it has to be as unique as possible to avoid duplicate classification ranges. 
    • FAK Value: The class value that will be added to the rate. 
    • Fak Start/End: Range of classes that will be then defaulting to the FAK Value. 
  3. Tariff Import: The section where the lanes are created based on previously added regions. 
    • Tariff Profile ID: It will populate automatically and doesn't need to be changed. 
    • Lane Calculation Type: Describes how the rate is going to be calculated, based on CWT, mileage, pieces, flat amount, etc. The cheat sheet will provide the number corresponding to each one of them. 
    • Module Name: This will only be used for SMC/CzarLite base pricing. Can be left blank. 
    • Priority: If the same lane is duplicated in the system with different lane criteria, the priority will determine which lane will provide the rate. 
    • Transit SCAC: From the carrier assigned to the lane.  
    • Intrastate: Can be left as "False." 
    • Origin Region Name/Destination Region Name: The lanes will be built using the region names for origin and/or destination. These names must match the region names for the import to work. 
    • Fak Group Name: Must match the FAK Name assigned previously. If no FAK is needed, like in the truckload's case, this field can be left as "NO FAK." 
    • Service Type: The cheat sheet will provide the code corresponding to the service type required. "All" corresponds to code 0. 
    • Transit Time: If available, enter the transit time days. If not, leave in 0. 
    •  Cost: Correspond to the rate for that lane. 
    • Minimum Cost: If there is a minimum cost criterion associated with the rate. 
    • Ignore Minimum Cost: True or false. 
    • Up Charge Calculation Type: Defaults to 6, or "Do not Upcharge." 
      • Fields for Upcharge Criteria can be found in columns P to R. 
    • And Or: Determines if the lane needs to meet all or any of the following criteria. 
      • Fields for Lane Criteria can be found in columns T to AL.
    • Billing Type: Defaults to 0 or "3rd Party."

When the file is ready to be uploaded, open the tariff profile and click Import/Export CSV > Import Tariff. Any existing lanes will be replaced with new ones. After the lanes are updated, upload the Excel file from Tariff Tools  > Documents. Make sure to have the date of the import on the document name for future changes and tracking purposes. 

Tariff Accessorials

Specifically, for manual tariffs and to have them rate a shipment with accessorials, the user may need to first add the accessorial to the tariff with the corresponding rate. Otherwise, the tariff may error out when trying the rate shipment. To do this, go to the tariff profile and click Accessorials > Tariff Accessorials. Once there, click Add New Accessorial Tariff. 

  1. Accessorial: Look for the accessorial to add to the tariff through the name. 
  2. Availability: Select "Required" to always have it display the accessorial and its rate, this is normally needed for Fuel pricing.  For Pickup/Delivery accessorials that are selected when needed, these need to have "Normal" selected. 
  3. Calculation type: This can vary from handling units to weight, percentage, and accessorial schedule. 
  4. Amount: Select the rate, including minimum or maximum. 
  5. Click Update

Note: The user can choose whether to apply a margin or not to the accessorial. The tariff link will determine the details of this margin. 

Fuel Schedules

To add a fuel schedule to the manual tariff, the schedule will need to be added to the system first. To do this, go to Rates > Accessorial Schedule > Add New Schedule

  • Name: Enter the schedule's name. 
  • Comments: Optional section for details. 
  • Valuation Type: Select between pieces, mileage, or weight. It can be changed to the actual value table in another section. 

Leave the "Is Master?" option unchecked and click Save. On the new edit page, the actual value table can be imported:

  • Valuation Type: Change to Value Table. 
  • Value Source: Select the currency value source, typically "Current U.S."
  • Offset days: Enter the number of days in a negative if the schedule is currently outdated. 
  •  Click the Import/Export CSV > Template to download the Fuel Schedule template.
    • Enter the minimum, maximum, calculation type (mileage, percentage, etc.), and amount on the template. 
  •  Click the Import/Export CSV > Import to upload the new details to the schedule. 

To add the schedule to the tariff, click the tariff profile and then Accessorials > Tariff Accessorials > Add New Accessorial tariff.

  • For the accessorial, select "Fuel - Fuel."
  • Availability: Select "Required" for the price to display when rating. 
  • Calculation Type: Select "Schedule." 
  • Look for the schedule created and click Save

Tariff Links and Sell Tariffs

To create a "Sell" or a pure customer tariff in the TMS, link it directly to the customer from Tariff Tools > Tariff Links. This way, the system will bypass the margin at the customer level and enter the same rate both in the buy and the sell fields.

For this workaround, the user can create a bogus carrier for the broker company and add it as the carrier on the tariff. To learn more about adding a master carrier, go to Add New LSP Carrier. After this, the user can select the rate, leave it as it is on the sell side, and look for the actual carrier to cover the load and replace it under the Cost Calculations section or from Truckload Quoting with the corrected buy amount. 

To add a tariff link to the customer: 

  1. From the tariff profile, click Tariff Tools > Tariff Links > Add New Tariff Link. 
  2. Under Type, select "Customer."
  3. For Organization, look for the customer to link the tariff to. 
  4. Under Permission, select "Allow." 
  5. For Block Inherited Rates, select yes or no, depending on the hierarchy in your account and the necessity to block tariffs coming from organizations above the customer level. 
  6. Click the check mark on the far right to save the tariff link. 

Once saved, a margin can be added to the link to mark up the linehaul and accessorials on the tariff. To learn more about setting up margins, go to Create a Margin.

*Note: Manual tariffs cannot be created for 3PLs.