1. ShipEngine
  2. ShipEngine Help Center
  3. Carrier Integrations

OnTrac

Avatar

ShipEngine Content Team

Updated

OnTrac is a regional carrier servicing California and the major metropolitan areas of Arizona, Colorado, Idaho, Nevada, Oregon, Utah, and Washington. View OnTrac's estimated delivery times for each of these states. OnTrac is is available for shipments originating in the US.

Interested in expanding your regional delivery options? Visit the OnTrac website to open an account!

2026 Migration to New OnTrac (V3) Integration via ShipStation

OnTrac is migrating all legacy OnTrac customers currently using ShipStation to the new Unified OnTrac integration (V3). ShipStation has adopted this integration over the past several months and is consolidating the number of OnTrac integrations it supports, so all customers will transition to the updated system.

What this means for you:

  • New account structure: Legacy accounts use a numeric Account Number; V3 uses Customer Branches (unique alphanumeric IDs) aligned to your current origin and injection locations.

  • Tracking number changes: Current format starts with "D"; new format starts with "1LS." Coordination with your third-party tracking providers may be required.

  • Invoice format updates: Invoices will move to a new format.

  • ShipStation setup required: You must add a new OnTrac carrier integration in ShipStation.

Migrating in ShipStation:

  • Contact OnTrac to request your new credentials. The new OnTrac API requires a different set of parameters than OnTrac Legacy or LaserShip.

  • Once you have your new credentials, connect your OnTrac account via the Carriers page just like connecting any other carrier.

OnTrac Requirements

Connection Requirements:

  • An active account with OnTrac

This table describes the Required and Optional fields when you connect your OnTrac V3 account.

Field

Type

Required

Description

ws_id

string

Green checkmark. Supported feature. Yes.

WSID

ws_key

string

Green checkmark. Supported feature. Yes.

WSKey

customer_branch

string

Green checkmark. Supported feature. Yes.

Customer Branch

pickup_time

string

Green checkmark. Supported feature. Yes.

Pickup Time

contact

string

Green checkmark. Supported feature. Yes.

Contact

street_address

string

Green checkmark. Supported feature. Yes.

Address

postal_code

string

Green checkmark. Supported feature. Yes.

Postal Code

city

string

Green checkmark. Supported feature. Yes.

City

state

string

Green checkmark. Supported feature. Yes.

State

special_instructions

string

Green checkmark. Supported feature. Yes.

Special Instructions

company

string

Red X mark. Unsupported feature. No.

Company

address2

string

Red X mark. Unsupported feature. No.

Address2

Iso_country_code

string

Red X mark. Unsupported feature. No.

ISO Country Code

phone

string

Red X mark. Unsupported feature. No.

Phone

declare_piece_attributes_separately_for_every_shipment

boolean

Red X mark. Unsupported feature. No.

Declare Piece Attributes Separately for Every Shipment

attr_alcohol

boolean

Red X mark. Unsupported feature. No.

Alcohol

attr_dryice

boolean

Red X mark. Unsupported feature. No.

DryIce

attr_explosive

boolean

Red X mark. Unsupported feature. No.

Explosive

attr_two_persons

boolean

Red X mark. Unsupported feature. No.

Two Persons

attr_controlled_substance

boolean

Red X mark. Unsupported feature. No.

Controlled Substance

attr_refrigerated

boolean

Red X mark. Unsupported feature. No.

Refrigerated

attr_perishable

boolean

Red X mark. Unsupported feature. No.

Perishable

attr_norts

boolean

Red X mark. Unsupported feature. No.

NoRTS

attr_desktop_delivery

boolean

Red X mark. Unsupported feature. No.

Desktop Delivery

attr_hazmat

boolean

Red X mark. Unsupported feature. No.

Hazmat

attr_saturday

boolean

Red X mark. Unsupported feature. No.

Saturday

attr_sunday

boolean

Red X mark. Unsupported feature. No.

Sunday

attr_signature_required

boolean

Red X mark. Unsupported feature. No.

SignatureRequired

Connect OnTrac to ShipStation API

To connect your OnTrac account in the ShipStation API dashboard:

  1. Select Carriers under the Setup section.

    Dashboard. Carriers section selected under ShipEngine Setup

  2. Click Connect my accounts under the My Carrier Accounts section.

    Carriers Setup screen with Connect My Own Accounts button shown

  3. Select your Ship From country for this carrier.

    Country selector shown in Connect Carrier Account popup

  4. Select the OnTrac V3 tile from the Available Carriers pop-up window.

    ontrac-v3_tile.png

  5. Enter the 10 required fields listed below, along with an Account Nickname to identify this carrier account in ShipStation API.

    Required fields:

    • ws_id

    • ws_key

    • customer_branch

    • pickup_time

    • contact

    • street_address

    • postal_code

    • city

    • state

    • special_instructions

  6. Click the Connect button.

Available Features for OnTrac

ShipStation API's integration with OnTrac supports the following standard features:

Key: Green checkmark. Supported feature. Yes. = Supported; Red X mark. Unsupported feature. No. = Not Supported; Grey dash icon. Not applicable. = Does Not Apply

Feature

Supported?

Domestic Shipping

Green checkmark. Supported feature. Yes.

International Shipping

Red X mark. Unsupported feature. No.

Electronic Customs Submission

Grey dash icon. Not applicable.

Return Labels

Red X mark. Unsupported feature. No.

Estimated Rates

Green checkmark. Supported feature. Yes.

Carrier Insurance

Green checkmark. Supported feature. Yes.

Tracking

Green checkmark. Supported feature. Yes.

End of Day (Electronic)

Red X mark. Unsupported feature. No.

End of Day (PDF)

Red X mark. Unsupported feature. No.

Label Branding

Red X mark. Unsupported feature. No.

Label Messages

Green checkmark. Supported feature. Yes.

Multi-package Shipping

Red X mark. Unsupported feature. No.

Multiple Accounts

Green checkmark. Supported feature. Yes.

Available Services, Packages, & Confirmation Types

OnTrac Domestic Services

  • OnTrac Ground Service

  • Palletized Freight Service

  • Sunrise Gold Service

  • Sunrise Service

OnTrac Package Types

  • Package

  • Letter

OnTrac Confirmation Options

  • Delivery

  • Signature

The carrier can be used to create domestic shipping labels.

The carrier can be used to create international shipping labels.

ShipStation API will submit international customs declarations electronically to the carrier.

The carrier can be used to create domestic return labels.

When an API call is made to the Rates endpoint, ShipEngine will return estimated shipping rates for the carrier based on the connected account information and shipment details.

Shipment insurance, provided by the shipment's selected carrier, can be added to the shipment in ShipStation API. This insurance would be in addition to any default coverage already provided by that carrier.

Shipping labels created for this carrier will include a tracking number that can be used to view the shipment status on the carrier's tracking website. Tracking may not be available for all shipping services.

Shipment manifests and End of Day documents are submitted electronically to the carrier by ShipEngine.

Shipment manifests and End of Day documents are generated as PDF files that can be printed along with shipping labels. Because these documents are not electronically submitted, physical copies must be provided to the carrier.

ShipEngine can print your brand logo on shipping labels from carriers that support this feature. Add your logo in the ShipEngine Dashboard.

ShipEngine can include additional information on a shipping label that is specified in the label request, if supported by the carrier.

This carrier can be used to create multi-package shipments, where multiple labels are created for a single shipment and the individual packages are linked together in a single shipment record with a master tracking number.

You can connect this carrier to ShipStation API multiple times using different accounts and choose which account will be used to create each shipment.

OnTrac Integration Notes

  • OnTrac supports Label Messages 1 and 2 only.

  • ShipStation API's OnTrac integration does not currently support third-party or recipient billing options.

OnTrac Troubleshooting Tips

Here are some common issues, potential causes, and troubleshooting tips.

Issue

How to Troubleshoot or Resolve

Invalid credentials error when attempting to connect OnTrac to ShipStation.

After you create an account with OnTrac, they will send you an email that contains your Account Number, WebOnTrac Login, and Password.

What to do: You must create a different password specific to ShipStation API, or you will receive an invalid credentials error message when attempting to connect your OnTrac account.

The carrier can be used to create domestic shipping labels.

The carrier can be used to create international shipping labels.

ShipStation API will submit international customs declarations electronically to the carrier.

The carrier can be used to create domestic return labels.

When an API call is made to the Rates endpoint, ShipEngine will return estimated shipping rates for the carrier based on the connected account information and shipment details.

Shipment insurance, provided by the shipment's selected carrier, can be added to the shipment in ShipStation API. This insurance would be in addition to any default coverage already provided by that carrier.

Shipping labels created for this carrier will include a tracking number that can be used to view the shipment status on the carrier's tracking website. Tracking may not be available for all shipping services.

Shipment manifests and End of Day documents are submitted electronically to the carrier by ShipEngine.

Shipment manifests and End of Day documents are generated as PDF files that can be printed along with shipping labels. Because these documents are not electronically submitted, physical copies must be provided to the carrier.

ShipEngine can print your brand logo on shipping labels from carriers that support this feature. Add your logo in the ShipEngine Dashboard.

ShipEngine can include additional information on a shipping label that is specified in the label request, if supported by the carrier.

This carrier can be used to create multi-package shipments, where multiple labels are created for a single shipment and the individual packages are linked together in a single shipment record with a master tracking number.

You can connect this carrier to ShipStation API multiple times using different accounts and choose which account will be used to create each shipment.

Articles in this section

See more
Didn't Find What You Were Looking For? Contact Support