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.
1
Connect your Asendia account to Zonos
You will need your Asendia Customer Engagement Portal (CEP) login.
Enter your Asendia account information as follows:
Site user ID - your Customer Engagement Portal username.
Passcode - the password for that portal user.
Click Save to finish.
Those two values are all we need. You do not need an Asendia client ID or client secret: Asendia issues API credentials to the integrating software provider rather than to the shipper, so Zonos authenticates with its own and your portal user tells Asendia which account to ship and bill on.
Asendia issues your portal login during onboarding. If you do not have it, contact your Asendia account representative.
2
Use the correct portal user
Your Site user ID is the CEP user Asendia created for your business, and it is what determines which account each order is booked and billed on. Enter the user that belongs to your business, and make sure it is the one Asendia enabled for API access.
If your portal login also works for a second Asendia account, use the one you ship on. Zonos cannot tell them apart - Asendia resolves the account from the authenticated user, not from anything in the shipment.
3
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.
Test your shipping - Confirm rates return as expected before going live.
4
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 portal login without calling Asendia to verify it, so an incorrect value - or a user Asendia has not enabled for API access - is reported when you create your first label rather than when you save the form.
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.
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":"USER_ID",
8"value":"your_portal_username"
9},
10{
11"type":"API_TOKEN",
12"value":"your_portal_password"
13}
14]
15}
16}
Asendia requires the following credential types:
USER_ID - your Customer Engagement Portal username
API_TOKEN - the password for that portal user
No client ID or secret is sent. Zonos authenticates with its own Asendia credentials and uses your portal user to tell Asendia which account to ship and bill on.
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.
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 your Asendia Customer Engagement Portal (CEP) login.
Go to Zonos Dashboard -> Settings -> Rates.
Click Add carrier.
Select Asendia.
Enter your Asendia account information as follows:
Click Save to finish.
Those two values are all we need. You do not need an Asendia client ID or client secret: Asendia issues API credentials to the integrating software provider rather than to the shipper, so Zonos authenticates with its own and your portal user tells Asendia which account to ship and bill on.
Asendia issues your portal login during onboarding. If you do not have it, contact your Asendia account representative.
Use the correct portal user
Your Site user ID is the CEP user Asendia created for your business, and it is what determines which account each order is booked and billed on. Enter the user that belongs to your business, and make sure it is the one Asendia enabled for API access.
If your portal login also works for a second Asendia account, use the one you ship on. Zonos cannot tell them apart - Asendia resolves the account from the authenticated user, not from anything in the shipment.
Enable your Asendia service levels
Connecting the account does not enable any service levels on its own. To start quoting and shipping:
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 portal login without calling Asendia to verify it, so an incorrect value - or a user Asendia has not enabled for API access - 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:
asendia.epaq_standardasendia.epaq_plusasendia.epaq_selectasendia.epaq_eliteNot currently supported for label creation:
asendia.epaq_select_direct_access)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
carrierAccountConnectmutation with theASENDIAcarrier code.{"input": {"carrierCode": "ASENDIA","rateType": "NEGOTIATED","credentials": [{"type": "USER_ID","value": "your_portal_username"},{"type": "API_TOKEN","value": "your_portal_password"}]}}Asendia requires the following credential types:
USER_ID- your Customer Engagement Portal usernameAPI_TOKEN- the password for that portal userNo client ID or secret is sent. Zonos authenticates with its own Asendia credentials and uses your portal user to tell Asendia which account to ship and bill on.
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
Was this page helpful?