How to configure Old Dominion (OLDDOMINIONV2) in techSHIP [Guide]

Last updated: November 16, 2026

This guide explains how to add and configure this carrier connection, review its available carrier-specific settings, and understand the shipment requirements and operational constraints that apply.

Carrier Requirements and Specifications

This section summarizes onboarding requirements and lists confirmed carrier-specific constraints.

To review all supported carriers and their specific requirements, see: 📄 techSHIP supported Carriers - Master List [Guides List].

Onboarding Requirements

The Old Dominion (ODFL) integration supports:

  • Void Orders

  • Rate Shopping

  • Time in Transit

  • 3rd Party Billing

  • Dangerous Goods

  • Insurance / Declared Value

  • Pickup Requests

  • LTL Accessorial Services

Information to be Provided

The following credentials and information are required or conditionally required to configure Old Dominion in techSHIP.

DATA ELEMENT

SOURCE (HOW TO OBTAIN)

API Username

Obtain API-enabled credentials from your Old Dominion representative.

API Password

Obtain the password associated with your Old Dominion API Username.

OD Bill-to Account Number

Obtain the appropriate account number from Old Dominion for account-specific rating and freight billing.

OD Shipper Account Number

Obtain the shipper account number when required by the selected payment arrangement.

Sender Address

Provide the shipping facility's complete address and contact information.

Pickup Information

Provide the pickup date and time, origin contact details and applicable pickup window.

The integration authenticates using the API Username and API Password. A separate API key is not required.

Ensure that the credentials and account numbers are authorized for the intended environment and freight services.

Specifications and Constraints

Operational Details

Old Dominion provides Less Than Truckload (LTL) freight transportation services.

The integration supports domestic rating and shipment processing, including supported routes involving the United States, Canada and Mexico. Service and route availability depend on the carrier and the applicable account.

Available service families include:

  • LTL

  • Guaranteed by 5pm

  • Guaranteed by Noon

Available tariff options depend on the selected service. These include Default, Security Divider, Volume and Pallet, where applicable.

Bill of Lading (BOL)

Old Dominion generates a Bill of Lading (BOL) during successful shipment processing.

The BOL and shipping labels are provided as PDF documents.

The shipment's PRO number is returned by the carrier and associated with the processed shipment.

Ensure that the shipment contains the required freight, address, billing and pickup information before processing.

Shipping Requirements

  • Shipment details: Provide at least one handling unit with its weight and the information required for the selected freight service.

  • Commodity information: Provide descriptions, quantities, weights and applicable freight classifications for supplied commodity lines.

  • Pickup schedule: A valid pickup date and time must be available before the BOL is generated.

  • Contact information: The resolved shipper, consignee and billing-party details must contain the information required by the carrier, including valid contact phone numbers.

  • Weight: Rating requests must not exceed 50,000 lb in total shipment weight.

  • Package types: Select the appropriate package type. Pallet and Pail are distinct package types.

  • Service-specific requirements: Some tariff options require additional package dimensions or commodity details.

Dangerous Goods

Old Dominion supports Dangerous Goods using the dangerous-goods information configured on the applicable Client Items.

For hazardous shipments:

  • Configure the required dangerous-goods information on each applicable SKU.

  • Ensure that the relevant commodity includes its UN/NA number, hazard class, proper shipping name and required weight information.

  • Provide a valid emergency contact name and emergency contact phone in the Client Account.

  • Enable Hazardous materials on the applicable Order.

Hazardous commodities must be associated with matching shipment line items. Configuring the Order option alone does not supply the required commodity details.

Configuring a Baseline Account

A Baseline Account serves as the fundamental connection point between techSHIP and the carrier's system. It acts as a template that holds the credentials and fundamental properties required to process shipments.

The techSHIP AI Assistant is available from the Carrier page for supported Carrier configuration tasks. For detailed conceptual information and advanced configuration, refer to 📄 techSHIP AI Assistant: Overview & Availability [Information].

Adding a Carrier

Before adding an account, you must ensure the Carrier entity is available for your location.

  1. Click My Carriers from the left menu under the Carriers category.

  2. Click Add Carrier.

  3. Select the desired Carrier.

You may encounter additional messages depending on the carrier status or your plan:

  • Subscription Required (⭐): If the carrier has a star icon, you will see a message stating "To use this carrier, a subscription upgrade is required." Press Contact to Upgrade to proceed.

  • Carrier Suspended: If the carrier has not been used for an extended period, you will see a message stating “This carrier is currently on hold...” Click Request Assistance to reactivate it.

  • Setup Fee Waived: If a carrier from the same carrier group is already installed in your location, you can add this carrier without incurring additional fees.

  1. If needed, update the carrier Name.

  2. Click Add Carrier.

If the purchase confirmation appears, complete the following steps:

  • Review the purchase notice and any applicable charge information.

  • Optionally enter a PO Number.

  • Select I am authorized to complete this purchase on behalf of my organization.

  • Click Purchase to confirm the Carrier addition.

Preview

Once the Carrier is added, you will be automatically redirected to the Carrier page to continue setting it up.

  1. Enter the Code of the Carrier as it appears in your host system.

The Code of the Carrier must match exactly the value defined in the host system. Any discrepancy (including casing or extra spaces) may prevent the carrier from working correctly.

  1. Click Save.

If your facility utilizes the centralized Pickup Schedule, we highly recommend adding this new carrier to your calendar now. While not required to process labels, this ensures accurate induction metrics for your Insights dashboards. To learn more, see 📄 Understanding the Centralized Pickup Schedule & Expected Induction Logic [Information].

Adding a Baseline Account

From the Carrier page, click Add Account to create a new Baseline Account.

You will be redirected to the Baseline Account page to complete the setup.

Entering incorrect values will prevent the system from generating shipping labels.

General Tab

In the General tab, define the administrative properties:

  • Name: Enter a descriptive name for the account.

Enter a descriptive name based on unique properties. E.g.:

  • Carrier Name - Account Number (CarrierX - 123456789)

  • Carrier Name - Consolidator Name (CarrierY - MyConsolidator)

  • Carrier Name

  • Usage: Select the most suitable option:

    • Test: Used for sandbox or onboarding purposes.

    • Production: Used for live shipping.

Keep the Status field set to its default Active value. An account must be Active to remain fully editable. For detailed conceptual information on account statuses, refer to 📄 How to Inactivate and Activate a Carrier Baseline Account [Step-by-Step Guide].

Carrier Tab

Old Dominion Credentials

Configure the following fields:

FIELD

DESCRIPTION

Username

Enter the API Username provided by Old Dominion.

Password

Enter the corresponding API Password.

OD bill-to account number

Enter the default bill-to account number used for account-specific rates and freight billing. This can be overridden in the Client Account.

Sender Address

Complete the Sender address fields with the shipping facility's information.

This address establishes the carrier-level origin information used when a client-specific or order-level override does not apply.

Ensure that the resolved origin includes the required company, contact and address information for shipment processing and pickup requests.

Labels Tab

Supported label format: PDF.

Old Dominion provides PDF shipping labels and a PDF Bill of Lading.

The carrier-specific Shipping label layout setting offers two layouts:

  • Zebra: 4 × 6 PDF label layout.

  • Avery: Alternative PDF label layout.

If no layout is configured, Zebra is used.

These are PDF layouts; selecting Zebra does not enable ZPL output.

Finalizing the Setup

Once you have entered the required information, click Save.

After you save the Baseline Account, check whether the Registration tab or a registration status badge is available.

If neither is available, the Carrier does not use this Registration workflow in techSHIP. If registration is still pending, open the Registration tab and press Registration, then complete 📄 How to Register a Carrier Baseline Account [Step-by-Step Guide] before creating shipments.

From the Carrier page, you can now see the Baseline Account listed with the administrative status Active. The Active status is separate from the account's registration status.

The Baseline Account configuration is now saved. You can continue with Configuring a Client Account below to assign the Baseline Account to a specific Client.

Configuring a Client Account

Adding an Account

Before adding a Client Account, ensure that the Client has been created. For instructions creating a Client, see: 📄 10 - How to create a Client profile [Step-by-Step guide].

  1. Click Clients from the left menu under the Clients section.

  2. Click the Edit icon for the desired Client.

  3. Click Add Accounts.

  4. Optionally, use the Search box to search by Baseline Account Name or Carrier.

  5. Select the Baseline Accounts that will serve as the foundation for your new Client Accounts.

  6. Click Add Accounts.

    A toast notification will confirm the accounts were successfully assigned. Click the Refresh icon if recently added accounts are not displayed.

  1. Click Edit on each newly created account.

  2. Configure the available options in each tab (except Carrier).

For complete instructions on configuring this settings, see 📄 How to configure the Billing Account General Options tab [Step-by-Step guide].

Carrier Tab

The Client Account inherits the underlying carrier connection and allows configuration of client-specific freight services, billing and shipment options.

Service and Freight Settings

FIELD

DESCRIPTION

Service code

Select the default Old Dominion service for the client.

Override WMS Service Code

Enable to apply the configured service instead of the WMS-provided service code.

Package type

Select the default package type used for freight shipments.

Default currency

Select the default freight currency.

Default freight class

Define the freight classification to use when a more specific value is unavailable.

Default NMFC code

Specify the applicable National Motor Freight Classification code.

Default commodity description

Provide the commodity description used when no more specific description is available.

Residential delivery

Specify the default residential-delivery setting.

Freight Billing

FIELD

DESCRIPTION

Default freight payment terms

Select Prepaid, Collect or Third party according to the applicable freight payment arrangement.

OD bill-to account number

Override the carrier-level bill-to account number for this client.

OD shipper account number

Specify the shipper account number used for origin identification and applicable billing arrangements.

Third-party billing address

Complete the payer's address and contact information when third-party billing applies.

The OD bill-to account number configured in the Client Account takes precedence over the carrier-level value.

Where order-level third-party billing overrides are enabled, the applicable Order billing account can take precedence for third-party freight payment.

Collect freight payment identifies a freight billing arrangement; it is not a Collect on Delivery (COD) service.

Sender Address and Contact Information

Configure the client-specific Sender name, Sender company, Contact phone, Contact email and sender-address fields as applicable.

Use these fields when the client requires origin or contact information different from the carrier-level configuration.

Additional Client Settings

FIELD

DESCRIPTION

Substitute missing ship-to phone

Enable substitution when an imported Order does not contain the required consignee phone.

Ship-to phone

Enter the substitution value when the option is enabled.

Emergency contact name

Enter the hazardous-materials emergency contact.

Emergency contact phone

Enter the corresponding contact phone number.

Emergency contract number

Provide the applicable hazardous-materials contract reference when available.

Notify shipper by email / phone

Request available shipper notifications.

Notify recipient by email / phone

Request available recipient notifications.

Customs Broker

When a customs broker must be included in the BOL, enable Specify customs broker and complete the applicable Broker type, company, contact, address and phone fields.

This configuration supplies broker information; it does not constitute a separate customs-invoice or duties-payment workflow.

Specifying Rate Shopping Service Codes

Old Dominion supports Rate Shopping for its implemented freight services.

Configure the service inclusion or exclusion list according to the services available under the applicable Old Dominion account.

For detailed instructions, see Include or exclude Service Codes when Rate Shopping [Step-by-Step Guide].

Label References

The References group on the Client Account's Carrier tab provides the following fields:

FIELD

DESCRIPTION

Shipment ID

Select the reference used for the BOL shipment identifier.

BOL #

Select the reference used for the Bill of Lading number.

PO # (comma separated)

Select the reference containing purchase order numbers.

Master BOL #

Select the reference used for the Master Bill of Lading number.

These are BOL-related references, not four interchangeable generic shipping-label reference fields.

For information about configuring reference values, see Using order References in your labels [Step-by-Step guide].

Finalizing the Setup

Once you have entered the required information, click Save.

With the account configured and requirements verified, you can now proceed to process orders as described below.

Configuring an Order

The steps described in this section are not required for carrier setup, and they are offered as an optional review if further order-level configuration is required.

Follow the UI Navigation steps in 📄 05 - How to edit an order’s information - [Step-by-Step guide], using the carrier-specific values provided in this guide.

Service and Freight Details

The following carrier-specific settings are available when configuring an Old Dominion Order.

FIELD

DESCRIPTION

Service code

Select the freight service for the shipment.

Pickup date/time

Specify the shipment's pickup schedule.

Currency

Specify the applicable freight currency.

Freight class

Specify the shipment's freight classification.

NMFC code

Enter the relevant NMFC classification.

NMFC sub code

Enter the applicable NMFC subclass.

Commodity description

Describe the freight being shipped.

Stackable

Indicate whether the freight handling units can be stacked.

Declared Value

The following fields control carrier insurance and declared-value information:

  • Insurance: Enable when carrier insurance is required.

  • Declared value: Specify a positive declared amount when Insurance is enabled.

  • Declared value currency: Select USD or CAD for the declared amount.

The declared-value information is supplied to the carrier when Insurance is enabled.

Accessorials

Configure the applicable accessorial services for the shipment.

FIELD

DESCRIPTION

Residential delivery

Specify whether residential delivery applies.

Liftgate pickup

Request liftgate assistance at pickup.

Liftgate delivery

Request liftgate assistance at delivery.

Inside pickup

Request inside pickup service.

Inside delivery

Request inside delivery service.

Scheduled appointment delivery

Request an appointment-based delivery.

Delivery appointment start

Specify the start of the appointment window.

Delivery appointment end date

Specify the appointment end date.

Delivery appointment end time

Specify the appointment end time.

Protect from freezing

Request protection from freezing.

Construction site delivery

Identify a construction-site delivery.

Limited access delivery

Request limited-access delivery.

Limited access destination

Select the destination type when limited access applies.

Sorting or segregating

Request freight sorting or segregation.

Food and food products (pickup)

Identify food products for the applicable pickup request.

Perishable goods (pickup)

Identify perishables for the applicable pickup request.

When Scheduled appointment delivery is enabled, provide the appointment start and end dates.

When Limited access delivery applies, select the appropriate destination type.

The food and perishable options apply to the pickup workflow, not as general rate or BOL accessorials.

Hazardous Materials

Enable Hazardous materials for the Order when the shipment contains configured hazardous commodities.

Ensure that the applicable SKUs have their dangerous-goods records configured and that the required emergency contact information is available in the Client Account.

Click Save to apply the order-level changes. After the Order is updated, continue with the standard shipping workflow.

Troubleshooting

  • Authentication fails: Verify that Username and Password contain API-enabled Old Dominion credentials for the selected environment. An API key is not required.

  • Rates are unavailable: Check the selected Service code, applicable account numbers, shipment weights, package dimensions and service eligibility.

  • Bill-to account validation fails: Verify the OD bill-to account number and payment arrangement in the Client Account. Ensure that the appropriate shipper account is also configured when required.

  • The BOL cannot be generated: Confirm that the Order contains a valid Pickup date/time, complete origin and destination information, consignee contact details, handling units and applicable commodity information.

  • The shipment requires a delivery appointment: Confirm that both the appointment start and end dates are provided.

  • A hazardous shipment is rejected: Verify the Order's Hazardous materials option, matching Client Item dangerous-goods records, required commodity data and emergency contact information.

  • The carrier rejects the label layout: Verify that Shipping label layout is configured as Zebra or Avery. The integration produces PDF documents.

  • A pickup request fails: Verify the pickup address, contact names, phone numbers and pickup date/time window. Shipments combined into one pickup must use compatible pickup information.

  • A shipment or pickup request times out: Verify its status with Old Dominion before retrying to avoid creating duplicate freight documents or pickup requests.

  • An Order cannot be voided: Verify that the shipment has a valid Old Dominion PRO number and that its BOL can be cancelled.