About
This newly upgraded Asendia API that replaced the legacy Asendia and Globegistics integrations that are currently on EasyPost.
Service Levels
Asendia USA offers many service levels. You can see the extensive list of service levels here, by selecting “Asendia USA” in the drop-down menu.
Predefined Packages
There are no predefined packages with this carrier.
Rating
Rating with Asendia USA is done over a rating API, and not rate tables, unlike the legacy integrations. So Asendia USA will pass back a given rate for their customers based on what is configured on their end.
Labels
Asendia USA supports three different label_formats only with a 4X6 inch size. (see Shipment Options):
- PNG
- ZPL
The labels are drawn by Asendia USA and then passed back to EasyPost.
Adding an Asendia Carrier Account
There are two necessary pieces of information for adding an Asendia USA carrier account to EasyPost. They are:
- Account Number
- Sub Account Number (Optional)
- Username
- Password
- API key
Carrier Account Type
The Asendia USA account type on EasyPost is named the following: AsendiaUsaAccount
The credential structure will look like the following:
{
"object": "CarrierType",
"type": "AsendiaUsaAccount",
"readable": "Asendia USA",
"logo": null,
"fields":
{
"credentials":
{
"account_number":
{
"visibility": "visible",
"label": "AsendiaUsa Account Number"
},
"sub_account_number":
{
"visibility": "visible",
"label": "AsendiaUsa Sub Account Number"
},
"username":
{
"visibility": "visible",
"label": "AsendiaUsa Username"
},
"password":
{
"visibility": "password",
"label": "AsendiaUsa Password"
},
"api_key":
{
"visibility": "masked",
"label": "AsendiaUsa API key"
}
},
"test_credentials":
{
"account_number":
{
"visibility": "visible",
"label": "Test AsendiaUsa Account Number"
},
"sub_account_number":
{
"visibility": "visible",
"label": "Test AsendiaUsa Sub Account Number"
},
"username":
{
"visibility": "visible",
"label": "Test AsendiaUsa Username"
},
"password":
{
"visibility": "password",
"label": "Test AsendiaUsa Password"
},
"api_key":
{
"visibility": "masked",
"label": "Test AsendiaUsa API key"
}
}
}
}
Here is an example CURL command to create an Asendia USA carrier account:
curl -X POST https://api.easypost.com/v2/carrier_accounts \
-u <PROD_API_KEY>: \
-d 'carrier_account[type]=AsendiaUsaAccount' \
-d 'carrier_account[description]=Asendia USA Test' \
-d 'carrier_account[reference]=Asendia USA Test' \
-d 'carrier_account[credentials][account_number]=account_number' \
-d 'carrier_account[credentials][sub_account_number]=sub_account_number' \
-d 'carrier_account[credentials][username]=username' \
-d 'carrier_account[credentials][password]=sub_account_number' \
-d 'carrier_account[credentials][api_key]=api_key' \
-d 'carrier_account[test_credentials][account_number]=account_number' \
-d 'carrier_account[test_credentials][sub_account_number]=sub_account_number' \
-d 'carrier_account[test_credentials][username]=username' \
-d 'carrier_account[test_credentials][password]=sub_account_number' \
-d 'carrier_account[test_credentials][api_key]=api_key'
Manifesting
Manifesting is not required with Asendia USA, the labels are valid in Asendia’s mailstream upon label creation.
Refunding/Voiding Labels
Asendia USA allows for voiding labels, as long as the shipment is in “pre_transit” still.
Returns
Asendia does not provide a separate service for "returns". Any shipments will be subject to regular pricing.
Comments
0 comments
Please sign in to leave a comment.