This article serves as the central hub for integrating Mainfreight LTL V2 with techSHIP. It details the necessary credentials for onboarding, explains the configuration hierarchy required to start shipping, and outlines operational constraints specific to this carrier.

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

TABLE OF CONTENTS

• Onboarding Requirements
  • Information to be Provided
  • Settings to be Verified
• Configuration Hierarchy and Guides
• Carrier Specifications and Constraints
  • Label References
  • Operational Constraints

Onboarding Requirements

Before configuring Mainfreight LTL V2 in techSHIP, you must gather specific credentials and verify account/workflow inputs required for rating and shipping. 

Information to be Provided

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

Settings to be Verified

The following configurations must be validated to prevent errors during rating or shipment processing:

Rating requests require a Delivery Date. If your source system does not provide it consistently, default it (for example, to the Pickup Date) before rate shopping or processing shipments.

Mainfreight LTL V2 supports PDF documents only. Select the required document type in the Baseline Account: US Label or US BOL.

Configuration Hierarchy and Guides

To establish a valid connection and start shipping, you must complete the mandatory levels in the following order: 

Gather Onboarding Requirements  ➔

Carrier Baseline Account ➔
Client (Billing) Account 

Use the table below to access the detailed configuration guides for each level:

LEVEL	COMPONENT	MANDATORY	SCOPE	DESCRIPTION	CONFIGURATION GUIDE
1	Onboarding Requirements		Requirements	You are here.
2	Baseline Account		Carrier	Establishes the core technical connection. Must be created first.	[ADD LINK]
3	(Billing) Account		Client	Connects a specific client to the Baseline. At least one is required to ship.	[ADD LINK]
4	Order Settings		Transaction	Defines advanced service options.	[ADD LINK]

Carrier Specifications and Constraints

This section outlines specific operational behaviors and data limitations inherent to the Mainfreight LTL V2 integration. 

Label References

While techSHIP supports the mapping of references within your labels, the final output is determined by the carrier's capabilities. The table below specifies the hard limits enforced by Mainfreight LTL V2. Data exceeding these limits may be truncated on the physical label or cause processing errors:

For a comprehensive guide on how to use label references , see: Using order References in your labels [Step-by-Step guide].

Operational Constraints

This section details specific operational rules and limitations imposed by Mainfreight LTL V2. These constraints are enforced by the carrier and must be considered when planning your shipping workflow:

• LTL only: This integration supports LTL workflows only.
• International scope: Supported for US → Canada lanes.
• Rating requires Delivery Date: A Delivery Date is mandatory for rate shopping/rating requests (default if missing).
• Whole-number weights only: Decimal weights are not supported by the carrier API.
• Freight lines: If two pieces are identical, two separate freight line entries are still required.
• Document output: PDF only.
• Document selection: Supported label types are US Label and US BOL, but the carrier API cannot return both document types together.

Mainfreight LTL V2 cannot return US Label and US BOL together. Select the document type required for your operation (US Label or US BOL) in the Baseline Account.