ESW Onboarding Requirements and Configuration Guides [Information]

Last updated: September 29, 2026

Onboarding and Configuration

Baseline Account

(Billing) Account

Order-Level Fields

You are here

You are here

   

This article is the central hub for adding ESW with techSHIP. It summarizes onboarding requirements, links the related configuration guides, and lists confirmed carrier-specific constraints.

   

   

Note

   

  

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

   

   

TABLE OF CONTENTS



Onboarding Requirements



Before configuring ESW in techSHIP, gather the required credentials and verify the required account settings.



Information to be Provided



The following credentials and data points must be available before starting the setup:

     

DATA ELEMENT

SOURCE / VALIDATION

Client Id

Obtain the Client Id from ESW for the brand integration.

Client secret

Obtain or generate the Client secret through ESW using an authorized account.

Brand code

Obtain the ESW brand code and confirm whether it will be configured in the Baseline Account, the Client (Billing) Account, or both.

ESW order reference

Confirm the source value that identifies the existing ESW order and is sent as orderReference.

Package reference

Confirm the source value sent to ESW as packageReference during package creation.

   

Settings to be Verified



The following account settings should be validated before configuring or testing the integration:

   

FEATURE / SETTING

VALIDATION ACTION

Billing Type

Confirm that ESW is configured as a Consolidator carrier.

Carrier code

Confirm that the configured carrier code is ESW.

Brand code location

Confirm whether the Brand code will be configured in the Baseline Account, the Client (Billing) Account, or both.

   

Setup Articles



Use the setup articles below to complete the setup in order. Start with onboarding requirements, then configure the Baseline Account, Client (Billing) Account, and optionally, Order-Level Fields. Select an article number to open the corresponding guide:

   

   

COMPONENT

ONBOARDING REQUIREMENTS

BASELINE ACCOUNT

(BILLING) ACCOUNT 

ORDER-LEVEL FIELDS

Mandatory

MandatoryMandatoryMandatory

Scope

Requirements

Carrier

Client

Transaction

Description

Identifies the required onboarding information and organizes the related setup guides for this carrier.

Establishes the carrier connection. Must be created first.

Connects a specific client to the Baseline. At least one is required to ship.

Defines order-level fields and settings used when processing shipments for this carrier.

    

Carrier Specifications and Constraints



This section outlines confirmed operational behaviors, document support, label support, and limitations specific to this carrier.



Labels



The following table summarizes confirmed label support:

    

ITEM

SUPPORTED

Label

Supported. Confirmed label formats are ZPL and PDF.

References

Supported with Reference 1 and Reference 2.

   

The table below summarizes the confirmed Label References support for ESW:

   

CONSTRAINT TYPE

LIMIT / REQUIREMENT

Supported references

Reference 1 and Reference 2

Reference count

2

Reference 1 use

Sent to ESW as orderReference.

Reference 2 use

Sent to ESW as parentOrderReference when configured.

Package reference source

Sent from Additional Carrier Data 1 as packageReference.

Character limit

Not Confirmed

   

   

Note

   

  

Confirm the expected label format with ESW before setup. The label format is configured by ESW and is not changed on demand in the package creation request.

   

   

   

Note

   

  

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

   

   

Operational Details



This section lists confirmed operational rules and limitations for this carrier:

  • ESW is configured as a single-code Consolidator carrier in techSHIP.

  • ESW handles final carrier and service selection internally for existing ESW orders.

  • techSHIP does not rate-shop ESW shipments.

   



Warning



Orders must already exist in ESW before they are processed in techSHIP. Use Reference 1 to provide the existing ESW order reference.

 

   



Warning



Do not configure RETURN as the Order type unless ESW confirms support for the client.

 

   

Next Steps



After reviewing the onboarding requirements, continue with the Reference Data: ESW Baseline Account Fields [Guide] article to configure the carrier connection in techSHIP.

   

   

Go to

Go to

 

Onboarding and Configuration

Baseline Account

(Billing) Account

Order-Level Fields