# Asendia USA Guide

Asendia USA offers international shipping solutions that cover a broad range of destinations including Europe, Asia, the Middle
East, Oceania, South America, the USA, and Canada. This service provides an economical option for reaching global markets,
ensuring cost-effective delivery solutions across continents.

This guide includes detailed information on utilizing Asendia USA shipping with the EasyPost API, focusing on account setup, rates,
label creation, manifests, tracking, and more.

---

## Prerequisites

### Account Registration

Sign up for an EasyPost account to obtain a **Test** and **Production** API
key. See Authentication and Key Management for more information.

> Note: Negotiated rates are only available in Production mode.

### Carrier Setup

Upon sign-up with EasyPost, users gain immediate access to Wallet Carrier Accounts,
which can be enabled directly from the Dashboard. For additional carriers,
EasyPost supports a Bring Your Own Account (BYOA) option. This requires users to register
directly with the respective carrier.

#### Asendia USA Shipper Account Registration

1. Contact Asendia USA to request a shipper account. A representative will be in touch for additional details regarding the account.
2. Inform Asendia USA about using EasyPost’s API for label purchases.
3. Acquire rates and align any additional shipping needs.
4. Obtain the following test and production account credentials:
   1. Asendia USA Account Number
   2. Asendia USA API Key
   3. Asendia USA Carrier Facility / Processing Location (Optional)
   4. Asendia USA Password
   5. Asendia USA Sub Account Number
   6. Asendia USA Username
5. Input carrier-specific credentials within the
   EasyPost Carrier Account Dashboard for comprehensive rate access.

#### Asendia USA Account via API

The API structure specified by EasyPost can also be used to add the Asendia USA carrier shipper account.

```shell
curl -X POST https://api.easypost.com/v2/carrier_accounts \
  -u "$EASYPOST_API_KEY": \
  -H 'Content-Type: application/json' \
  -d '{
  "carrier_account": {
    "type": "AsendiaUsaAccount",
    "description": "AsendiaUsaAccount",
    "credentials": {
      "account_number": "VALUE",
      "api_key": "VALUE",
      "carrier_facility": "VALUE",
      "password": "VALUE",
      "sub_account_number": "VALUE",
      "username": "VALUE"
    },
    "test_credentials": {
      "account_number": "VALUE",
      "api_key": "VALUE",
      "carrier_facility": "VALUE",
      "password": "VALUE",
      "sub_account_number": "VALUE",
      "username": "VALUE"
    }
  }
}'
```

### Software Requirements

Download an EasyPost Client Library or utilize the REST API with cURL.

### Documentation Review

Examine the EasyPost Objects section to understand the API's structure, which is critical for constructing requests and interpreting responses.

Related:

- [Getting Started Guide](https://docs.easypost.com/guides/getting-started)
- [Manage Carrier Accounts](https://app.easypost.com/account/settings?tab=carriers)

---

## Rates

Asendia USA is a **Live Rating** integration, enabling real-time rate retrieval for shipments created via EasyPost. Rates are guaranteed valid for a minimum of five minutes.

- When creating a shipment, EasyPost requests Asendia USA for shipment rates specific to the user's Asendia USA account.
- The rates provided are directly from Asendia USA and tailored to the user's specific account details.
- In cases of discrepancies or incorrect rates, users are advised to contact their Asendia USA account representative.
- The representative can then update the rates to ensure user account accuracy.

---

## Service Levels

Asendia USA offers the following service levels:

Service levels are generated from live carrier metadata and are not included in this file. Retrieve them from the Carrier Metadata endpoint: https://docs.easypost.com/docs/carrier-metadata. Use `carrier=asendiausa`.

---

## Predefined Packages

There are no predefined packages for Asendia USA.

---

## Generating Shipping Labels

With EasyPost, generating shipping labels for Asendia USA is the same process as generating them for any other carrier.

Review the Getting Started Guide for help generating a shipping label.

### Manifests

Manifesting is **not** supported or required for Asendia USA.

### Supported Options

#### Voiding Labels

Asendia USA labels can be voided through EasyPost provided the shipment has not yet entered the mail stream.

#### Label Formats

EasyPost offers native Asendia USA labels in PNG, PDF, and ZPL formats.

Related:

- [Shipment Documentation](https://docs.easypost.com/docs/shipments)
- [Reducing API Response Times](https://support.easypost.com/hc/en-us/articles/360048825772-Reducing-API-Response-Times)

---

## Hazardous Materials (HAZMAT)

The Asendia USA policy on hazardous materials is not explicitly detailed in this guide. Shippers are advised to
contact Asendia USA directly for specific hazmat inquiries.

---

## Pickups

Asendia USA accommodates pickups based on individual agreements with customers. While regular pickups can be arranged directly with
Asendia USA during the account registration process, they **cannot be scheduled via the EasyPost API**.

---

## Tracking

EasyPost simplifies package tracking by offering two methods:

- Tracking with an existing number and carrier.
- Using a Tracker included with an EasyPost-purchased shipping label.

The service integrates webhooks for timely shipment updates. For detailed information on
tracking methods, visit the Tracking Guide.

Related:

- [Trackers Documentation](https://docs.easypost.com/docs/trackers)
- [Trackers Guide](https://docs.easypost.com/guides/tracking-guide)

---

## Additional Resources

### Carrier Metadata

The Carrier Metadata endpoint can programmatically return information about service
levels, predefined packages, supported features, and shipment options.

Use this information to quickly integrate and make educated decisions about the mix of carriers for shipping needs. Additionally,
the Carrier Metadata endpoint is available to retrieve comprehensive information about
all carriers on the EasyPost platform, enhancing decision-making for carrier services.

### Support and Troubleshooting

In addition to the guidance provided in our Carrier Guides, EasyPost offers support to assist with FAQs, troubleshooting issues, and inquiries related to the EasyPost platform.

Please visit the Help Center for more information.

Related:

- [Carrier Metadata](https://docs.easypost.com/docs/carrier-metadata)
- [Help Center](https://support.easypost.com/hc/en-us)

---

## Talk to a Shipping Expert

For questions about getting started with the EasyPost API please talk to a Shipping Expert or Contact Support.

Related:

- [Talk to a Shipping Expert](https://www.easypost.com/talk-to-easypost)
- [Contact Support](https://support.easypost.com/hc/requests/new)