• Overview
• Before You Begin
• Getting a TForce Freight Client ID and Secret
• Connecting TForce Freight to Cart.com
• Testing Your TForce Freight Integration
• Error Messages and Troubleshooting

Overview

Your store can automatically calculate Less-Than-Truckload (LTL) freight shipping rates using the TForce Freight shipping provider. To configure this integration, you will need a TForce Freight account and the appropriate API credentials.

TForce Freight, formerly UPS Freight, operates separately from UPS parcel shipping. TForce Freight uses its own developer portal and API authentication system.

Important: Credentials created through the UPS Developer Portal are not interchangeable with TForce Freight API credentials. If you currently use UPS parcel shipping, you should leave your existing UPS provider settings unchanged.

This article covers obtaining credentials through the TForce Freight Developer Portal, configuring the shipping provider in Cart.com, and testing freight rate calculations.

For standard UPS parcel shipping, see our Setup UPS Shipping Provider article.

Before You Begin

Before configuring the TForce Freight integration, you will need:

• An active TForce Freight shipping account.
• Access to the TForce Freight Developer Portal.

Note: If you do not have access to the TForce Freight Developer Portal or your account is not authorized for API rating services, contact TForce Freight for assistance.

Getting a TForce Freight Client ID and Secret

TForce Freight uses OAuth authentication for its APIs. Follow the steps below to locate your Client ID and generate a Client Secret.

• Navigate to the TForce Freight Developer Portal.
• Sign in to your existing developer account or register for access if you do not already have an account.
• After signing in, navigate to your developer Profile.
• Click Configure My Client to open the OAuth Client configuration dialog.

Within the OAuth Client configuration dialog, you will find several sections used to manage your application.

• Under Your OAuth Client, enter a descriptive Display Name for your integration if needed.
• Locate your Client ID in the OAuth Client configuration and copy it for use in your shipping provider settings.
• Navigate to the OAuth Client Secrets section.
• Create a new Client Secret. Enter a description to identify its purpose and select an appropriate expiration period using the Expires field.
• Copy the generated Client Secret value immediately and store it securely.

Important: TForce Freight only displays the Client Secret value immediately after it is created. You will not be able to retrieve the same secret value later. If the secret is lost or expires, you will need to create a new one.

For additional details, please refer to the official TForce Freight End User Integration Guide.

Connecting TForce Freight to Cart.com

Once you have obtained your TForce Freight API credentials, you can configure the shipping provider in your Cart.com store.

• Navigate to Storefront > Settings > Shipping > Shipping Providers.
• Locate the TForceFreight (UPSFreight) shipping provider and click the edit icon.
• Enter the API credentials and any desired markup for the provider configuration.
• Check Active to enable the shipping provider.
• Click Save to save your configuration.

Once the provider is active, review the available freight shipping services and enable the services you want to offer at checkout.

For more information about enabling individual shipping services, see our Shipping Provider Live Rate Setup article.

Testing Your TForce Freight Integration

After saving your shipping provider configuration, we recommend testing the connection before using the provider for live checkout rates.

• Navigate to Storefront > Settings > Shipping > Shipping Providers.
• Edit your TForce Freight provider.
• Use the Test Connection button below the provider settings. 
• Review the response for any authentication errors or rate calculation issues.

Once the connection is successful, test the shipping rates using an order that qualifies for LTL freight shipping. Verify that the shipping origin, destination, shipment weight, and other required freight information are accurate.

Error Messages and Troubleshooting

Authentication or Invalid Credentials Errors

If you receive an authentication error when saving or testing the TForce Freight provider, verify the following:

• Your Client ID and Client Secret were obtained from the TForce Freight Developer Portal, not the UPS Developer Portal.
• You entered the actual Client Secret value rather than the Secret ID.
• Your Client Secret has not expired or been revoked.
• Your TForce Freight account and application have the necessary authorization for the API services being requested.
• Your updated credentials have been saved successfully in your shipping provider settings.

If your Client Secret has expired or is no longer available, create a new secret in the TForce Freight Developer Portal and update your shipping provider configuration.

No Freight Rates Returned

If your credentials test successfully but freight rates are not displayed at checkout, check the following:

• The TForce Freight shipping provider is active.
• The appropriate freight shipping services are active.
• Your shipping regions are configured correctly.
• The shipment origin and destination are valid.
• Your products contain accurate shipment weights and any other required freight information.
• The requested shipment qualifies for the available TForce Freight services.

For assistance with TForce Freight account registration, API authorization, or developer portal access, you can also contact TForce Freight API Support at groundfreightapisupport@tforcefreight.com.