# USA Export - Powered by Asendia Guide

USA Export - Powered by Asendia is an EasyPost-exclusive international shipping solution that utilizes USPS for the first-mile delivery and Asendia USA
for export to destinations all over the globe. This service is ideal for shippers with packages ranging from sub-pound up to 66 pounds and offers
competitive rates via EasyPost-powered carrier accounts.

This guide includes detailed information on utilizing USA Export - Powered by Asendia 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

#### USA Export - Powered by Asendia Account Setup

1. Log in to the EasyPost Dashboard.
2. Navigate to **Account Settings** > **Carriers** > **EasyPost Carrier Accounts**.
3. Locate **USA Export—Powered by Asendia** and click **Create Account**. Upon initiating setup, the user will receive an email outlining the necessary steps to complete the process.
4. Click the **[ ⋯ ]** menu next to the added account and select **Edit Account**.
5. Complete all required fields. An email will be sent confirming the account setup.

#### USA Export - Powered by Asendia Account via API

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

> Note: Credentials are used as endshipper details for the first-mile USPS leg of the shipment. EasyPost Platform
  users shipping on behalf of others should use the endshipper API to generate and
  send endshippers to the buy API endpoint and leave credentials blank.

```shell
curl -X POST https://api.easypost.com/v2/carrier_accounts \
  -u "$EASYPOST_API_KEY": \
  -H 'Content-Type: application/json' \
  -d '{
  "carrier_account": {
    "type": "UsaExportPbaAccount",
    "description": "UsaExportPbaAccount",
    "credentials": {
      "address_city": "VALUE",
      "address_state": "VALUE",
      "address_street": "VALUE",
      "address_street2": "VALUE",
      "address_zip": "VALUE",
      "company_name": "VALUE",
      "country": "VALUE",
      "email": "VALUE",
      "name": "VALUE",
      "phone": "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

USA Export - Powered by Asendia is a **Live Rating** integration, enabling real-time rate retrieval for shipments created via EasyPost.

- Rates for USPS and Asendia USA are returned through the EasyPost and Asendia USA APIs, respectively.
- Separate rate adjustments may occur for USPS and Asendia USA.

---

## Billing

USA Export - Powered by Asendia is an aggregate carrier. This means the shipping workflow involves multiple carrier services combined
into one, with USPS handling the first mile and Asendia USA handling the international export leg.

Billing is managed entirely through the EasyPost Wallet:

- Both USPS and Asendia USA charges are applied at the time of label purchase.
- These may appear as two separate price adjustments–one for each carrier segment.
- All rates are pre-negotiated and billed through EasyPost. No direct billing occurs with USPS or Asendia USA.

This process allows EasyPost to provide a streamlined international shipping solution using multiple underlying carriers, while
consolidating charges into a single EasyPost-managed transaction.

Related:

- [EasyPost Wallet and Bring Your Own Account Plans](https://support.easypost.com/hc/en-us/articles/39984592062605-EasyPost-Wallet-and-Bring-Your-Own-Carrier-Account-Plans)
- [Billing & Payments](https://support.easypost.com/hc/en-us/articles/360042414212-Billing-Payments)

---

## Service Levels

USA Export - Powered by Asendia 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=usaexportpba`.

---

## Predefined Packages

All USPS predefined packages are accepted if a weight is provided.

Related:

- [Predefined Packages](https://docs.easypost.com/docs/parcels#predefined-packages)

---

## Generating Shipping Labels

Label generation for USA Export - Powered by Asendia differs slightly from standard carrier workflows. A USPS label is generated for each shipment.
This label is addressed to the Asendia hub. The Asendia hub will re-label the shipment to its final international destination.

### Special Requirements

- **Customs Items:** The `customs_items` object must include a code string (e.g., SKU or UPC).
- **EasyPost Platform Users:** EndShipper addresses must be included in all shipments due to USPS first-mile handling. An EndShipper refers to the final shipper on whose behalf a platform is purchasing postage. Refer to the EasyPost EndShipper documentation for more details.

#### Manifests

Manifesting is not supported or required.

#### One-Call Buys

One-call buys are not supported at this time.

#### Returns

Returns are not supported at this time.

### Supported Options

#### Voiding Labels

Supported asynchronously. Refunds may take up to 24 hours.

#### Label Formats

EasyPost offers labels in PNG, PDF, and ZPL formats.

Related:

- [Shipment Documentation](https://docs.easypost.com/docs/shipments)

---

## Hazardous Materials (HAZMAT)

The USA Export - Powered by Asendia policy on hazardous materials is not explicitly detailed in this guide. At this time, hazmat is not supported.

---

## Pickups

Pickups are not supported and **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.

> Note: The USA Export - Powered by Asendia services provide end-to-end tracking visibility for all services except
  for the USA Export Standard service level, which provides limited tracking details up to delivery into the destination
  country.

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)