HomeGlobal ecommerce Fulfillment Carriers Labels

Asendia labels

Create Asendia ePAQ labels on your own carrier account.

Connect your Asendia account to Zonos Dashboard and create Asendia ePAQ shipping labels directly from your shipments, on your own account and your own negotiated pricing.

This guide covers connecting the account, enabling the service levels you ship, and creating your first label.

Connect your Asendia account to Zonos

You will need credentials from the Asendia Customer Engagement Portal (CEP).

Go to Zonos Dashboard -> Settings -> Rates.
Click Add carrier.
Select Asendia.
Enter your Asendia account information as follows:
1. API key - your Asendia client ID.
2. API password - your Asendia client secret.
3. Site user ID - your Customer Engagement Portal username.
4. Passcode - the password for that portal user.
Click Save to finish.

Asendia issues these during your onboarding. If you do not have them, contact your Asendia account representative.

Use one account for all four values

All four values must come from the same Asendia account. The client ID and secret identify the application, and the portal username and password identify the user, but Asendia authenticates them together as a single request.

Mixing values from two accounts - for example a client ID from one and a portal user from another - fails to authenticate, or authenticates as the wrong party.

Enable your Asendia service levels

Connecting the account does not enable any service levels on its own. To start quoting and shipping:

Create shipping zones - Shipping zones let you offer different service levels and rates to different countries.
Enable Asendia service levels - Turn on the service levels you ship in each zone.
Test your shipping - Confirm rates return as expected before going live.

Create your first label

Create a label the same way as any other carrier - see Create a label.

Run one test shipment as soon as you connect the account. Zonos stores your Asendia credentials without calling Asendia to verify them, so an incorrect value is reported when you create your first label rather than when you save the form.

Supported service levels

Zonos can create labels for these Asendia products:

Service level↕	Code↕
ePAQ Standard	`asendia.epaq_standard`
ePAQ Plus	`asendia.epaq_plus`
ePAQ Select	`asendia.epaq_select`
ePAQ Elite	`asendia.epaq_elite`

Not currently supported for label creation:

ePAQ Select Direct Access (asendia.epaq_select_direct_access)
Asendia Custom (asendia.custom)

A label request on either of these is rejected rather than booked, because Zonos cannot determine which Asendia product to send. If you need Direct Access, contact Zonos support so we can confirm the correct product with Asendia before you ship on it.

Which of the supported products you can ship also depends on what Asendia has enabled on your account.

Connect via API

If you connect carrier accounts programmatically rather than through Dashboard, use the carrierAccountConnect mutation with the ASENDIA carrier code.

1{

2 "input": {

3 "carrierCode": "ASENDIA",

4 "rateType": "NEGOTIATED",

5 "credentials": [

6 {

7 "type": "API_KEY",

8 "value": "your_client_id"

9 },

10 {

11 "type": "API_PASSWORD",

12 "value": "your_client_secret"

13 },

14 {

15 "type": "USER_ID",

16 "value": "your_portal_username"

17 },

18 {

19 "type": "API_TOKEN",

20 "value": "your_portal_password"

21 }

22 ]

23 }

24}

Asendia requires the following credential types:

API_KEY - your Asendia client ID
API_PASSWORD - your Asendia client secret
USER_ID - your Customer Engagement Portal username
API_TOKEN - the password for that portal user

For the full mutation and response shape, see Connect via API. Connecting an Asendia account does not make a test rating call, so the mutation succeeds as long as the credential types are valid.

Next steps

Create a label - Generate labels on your connected account
Label errors - Troubleshoot a failed label

Book a demo