How to configure GOFO (GOFO) in techSHIP [Guide]

Last updated: October 28, 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 GOFO integration supports:

  • Void

  • Rate Shopping

  • Label References

  • Sender Address Override

  • Multi-package Orders

Information to be Provided

The following credentials and data points are mandatory to connect to GOFO. Ensure you have these items available before starting the setup:

DATA ELEMENT

SOURCE (HOW TO OBTAIN)

API username and password

Provided by GOFO for the applicable test or production account.

Sender address and contact information

Provided by your shipping facility, including the sender's name, company, street address, city, state, ZIP code, country, and phone number.

Pickup opening time, closing time, and preparation time

Provided by your shipping facility for the Baseline Account configuration.

Entry port

Confirm the appropriate selection with GOFO for your shipments.

Confirm with GOFO that your account has access to the intended environment and services and that its receivable settlement settings are configured. Missing settlement configuration can prevent rate retrieval and shipment processing.

Specifications and Constraints

Operational Details

GOFO supports Small Parcel shipping within the United States. Available services are GOFO Parcel Pickup and GOFO Ground Pickup, subject to your account's service access and settlement configuration.

Each package in a multi-package order receives its own tracking number and label and is canceled separately when the order is voided. Shipment processing requires a successful rate for the selected service.

Bill of Lading (BOL): This integration does not provide a BOL.

  • Package weight and dimensions: Each package must weigh between 0.001 and 99 lb. Length, width, and height must each be between 1 and 999 inches. Weight is rounded to three decimal places and dimensions to two.

  • Address and contact data: Both sender and recipient require a name, street address, city, state, ZIP code, country, and phone number. Phone numbers must contain 10–14 characters.

  • Name and street limits: The combined sender name and company cannot exceed 50 characters, and the combined sender street address cannot exceed 100 characters. The combined recipient name and company cannot exceed 100 characters, and the recipient's first address line cannot exceed 130 characters.

  • Delivery instructions: Keep shipment delivery instructions within 120 characters.

  • Item quantities: Use whole numbers. Positive fractional quantities are rejected; missing or non-positive quantities are treated as 1.

  • Package value: The integration calculates the package value from line-item prices and quantities in USD, with a minimum value of 1. A missing unit price is treated as 1. If no line items exist, the integration supplies a default item with quantity 1 and a package value of 1.

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

Credentials

  • Username: Enter the API username provided by GOFO. Required.

  • Password: Enter the API password provided by GOFO. Required.

Use credentials that match the Baseline Account's Usage selection in the General tab.

Pickup Configuration

  • Pickup open time: Enter your facility's pickup opening time. Required.

  • Pickup close time: Enter your facility's pickup closing time. Required. This time is applied to the same date as the pickup date resolved by techSHIP.

  • Pickup ready hours: Enter the number of hours your facility needs to prepare shipments for pickup. Required.

  • Weekends mode: Select how weekends are handled when techSHIP calculates a pickup date from the account settings.

Sender Address

In Sender address, complete Sender name, Sender company, Address 1, City, State/province, Zip, and Country. Use Address 2 and Address 3 when needed.

  • Phone: Enter the sender's phone number. Required; use 10–14 characters.

  • Email: Optionally enter the sender's email address.

Labels Tab

Set Mode to PDF, ZPL, or PNG.

GOFO supplies PDF and ZPL labels. For PNG output, techSHIP retrieves a ZPL label and converts it to PNG. Each package has its own label.

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

  • Service code: Select the GOFO service to use for this client.

  • Override WMS Service Code: Enable this option to use the Client Account's service selection instead of the service code supplied by the Integrated system.

  • Entry port: Select the entry port confirmed with GOFO. An Entry port specified on the Order takes precedence.

  • Default contents description: Enter a fallback description. It is used when neither the package nor the Order supplies a contents description.

Sender Address Override

In Sender address override, enable Override sender address when this client needs a different sender address from the Baseline Account. Complete the address and contact information, including a phone number with 10–14 characters.

Sender name and Sender company can override the Baseline Account's corresponding values independently of Override sender address. An explicit ship-from address on the Order takes precedence over the Client Account's sender address.

Specifying Rate Shopping Service Codes

If you use Rate Shopping, restrict the comparison to the GOFO services enabled for your account.

For detailed instructions on how to configure this, see: Include or exclude Service Codes when Rate Shopping [Step-by-Step Guide].

Label References

GOFO supports four optional label references. Configure Reference 1, Reference 2, Reference 3, and Reference 4 in the Labels group of the Client Account's General tab.

Keep Reference 1 and Reference 2 within 30 characters each, and Reference 3 and Reference 4 within 32 characters each. A reference is omitted when its selected source resolves to an empty value.

For a comprehensive guide on how to use label references, 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.

In the Order's Carrier tab, configure the following GOFO fields when needed:

  • Service code: Select the GOFO service for the shipment.

  • Contents description: Enter the shipment contents description. A package-level description takes precedence; otherwise, this value is used before the Client Account's Default contents description.

  • Entry port: Select an entry port for this shipment to override the Client Account's Entry port.

  • Pickup date: Specify the shipment's pickup date. techSHIP uses the resolved pickup date and time for the pickup start and applies the Baseline Account's Pickup close time to that same date.

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

Troubleshooting

  • Connection or authentication fails: In the Baseline Account's Carrier tab, verify Username and Password. Confirm that these credentials belong to the environment selected under Usage in the General tab.

  • Rates fail or shipment processing cannot proceed: Check the selected Service code in the Client Account or Order's Carrier tab. Ask GOFO to confirm access and receivable settlement configuration for that service. Shipment processing cannot proceed without a successful rate.

  • Package data is rejected: Review each package's weight and dimensions against the limits above, and check its item quantities for positive fractional values. Correct the affected package before processing.

  • Sender or recipient data is rejected: Check the effective sender and recipient addresses, required contact information, and phone lengths. For a client-specific sender, review Override sender address in the Client Account's Carrier tab; also check whether the Order supplies its own ship-from address.

  • A reference is missing: In the Client Account's General tab, check the configured reference source and confirm that the Order contains a value for it. Empty resolved values are omitted.

  • A label cannot be retrieved: Confirm that the affected package has a GOFO tracking number and that the Baseline Account's Mode in the Labels tab is PDF, ZPL, or PNG. If the carrier reports missing or invalid label data, provide the package's tracking number and the returned error to support.

  • A void fails: Confirm that the Order retains its carrier account and that its processed packages have GOFO tracking numbers. For a multi-package order, review the reported cancellation errors for each affected tracking number.