Handle Easy Ship Cross-Border Orders

Learn how to handle Easy Ship cross-border orders.

Prerequisites

To complete this tutorial, you need:

• Authorization from the selling partner for whom you are making calls. For more information, refer to Authorizing Selling Partner API applications.
• The shipment ID of the shipment you want to process.
• Approval for the Direct-to-Consumer Shipping (Restricted) role in your developer profile.
• The Direct-to-Consumer Shipping (Restricted) role selected in the App registration page for your application.

Step 1. Identify cross-border requirements

Call the getShipments or getShipment operation. Examine the following attributes in the response:

• countryOfOriginRequirement: If REQUIRED, the shipment is cross-border.
• itemValueRequirement: If REQUIRED, you must declare the value of items.
• recommendedCurrencyCode: The currency to use for the item value provided with the createPackage operation.
• recommendedCountryOfOrigin: The country of origin to use with the createPackage operation.

These values must be provided for cross-border orders.

Step 2. Process the shipment

Follow the Process a Shipment tutorial to process the shipment. In Step 2 of that tutorial, call createPackages with the cross-border information you retrieved in Step 1 of this tutorial. Use the recommendedCountryOfOrigin value from getShipment or getShipments as the countryOfOrigin value in your call to createPackages. Similarly, use the recommendedCurrencyCode value as the currency value.