Amazon
Ensure you have provided credentials to ship with Amazon.
Amazon - Ship With Amazon requirements
Prior to shipping with Amazon - Ship With Amazon, you must configure credentials in the Shipium Console. You'll provide an Amazon Business ID for production and test mode.
Potential values for the Amazon Business ID are included in the following table.
| Amazon Business ID | Description |
|---|---|
| AmazonShipping_US | The United States Amazon shipping business |
| AmazonShipping_IN | The India Amazon shipping business |
| AmazonShipping_UK | The United Kingdom Amazon shipping business |
| AmazonShipping_IT | The Italy Amazon shipping business |
| AmazonShipping_ES | The Spain Amazon shipping business |
| AmazonShipping_FR | The France Amazon shipping business |
| AmazonShipping_JP | The Japan Amazon shipping business |
Account registration verification for Ship With Amazon
In addition to providing required credentials, you'll need to verify your account registration via Ship With Amazon. Your dedicated Implementation Team member will assist you with account setup and verification. Once your Ship With Amazon account has been created in the Shipium platform, your Shipium contact will send you a URL link for account registration verification via your web browser. You'll see an authorization modal like the one below. You will need to check the box next to the "I understand" statement and select the Authorize button. Then you'll see a success message that your registration was verified.
API call requirements for Ship With Amazon
When shipping with Amazon - Ship With Amazon, you must include the required fields listed in the following table in your API call. A sample call to our Carrier and Method Selection & Shipment Label API is included in this documentation. For multi-parcel shipments, these required fields would be included in the multiParcelShipmentParameters.
Reference field | Required/Optional | Field properties | Description |
|---|---|---|---|
| Required | String | The source of the order that was placed; if the source is Amazon Marketplace, you'll enter |
| Required if the value provided for | String | Carrier-provided identifier; this is the purchase order number from the order step via Amazon. |
| Required for international shipments and shipments containing hazardous materials | String enumeration
| The specific packing instruction of the item being shipped |
| Required | Number | The value of the weight; this value may also be included in ``` customsInfo.customsItems.customsWeight .weight shipmentParameters .orderItemQuantities .itemWeight .weightUnit |
Customs item to order item quantity mapping
For international shipments with Amazon - Ship With Amazon, accurate customs declaration requires a precise mapping between the items declared in your customs information and the corresponding items within each package. Shipium facilitates this by connecting the productId values in your customsInfo.customsItems with the productId values in your package's orderItemQuantities.
You can find more information in Customs Info for Shipments.
Amazon - Vendor Direct Fulfillment requirements
Prior to shipping with Amazon - Vendor Direct Fulfillment, you must configure credentials in the Shipium Console. You'll provide a VDF Selling Party ID Token and a VDF Ship From ID Token for production and test mode. The VDF Selling Party ID Token credential is your Amazon-related Selling Party value, or the vendor code assigned to the vendor. You'll enter your Amazon Ship From Party value, or the warehouse code assigned to the warehouse, for the VDF Ship From ID Token credential.
Account registration verification for Vendor Direct Fulfillment
In addition to providing required credentials, you'll need to verify your account registration via Vendor Direct Fulfillment. Your dedicated Implementation Team member will assist you with account setup and verification. Once your Vendor Direct Fulfillment account has been created in the Shipium platform, your Shipium contact will send you a URL link for account registration verification via your web browser. You'll see an authorization modal like the one below. You will need to check the box next to the "I understand" statement and select the Authorize button. Then you'll see a success message that your registration was verified.
API call requirements for Vendor Direct Fulfillment
All API calls for Amazon - Vendor Direct Fulfillment must have test mode set to a value of "false", as Vendor Direct Fulfillment does not support test mode. Any requests sent with testMode=true will fail. In addition, since all testing must be performed in production mode, you must use real, valid purchase orders. The purchase order number should be unique for each call and should not be reused.
When shipping with Amazon - Vendor Direct Fulfillment, you must include the required fields listed in the following table in your API call. A sample call to our Carrier and Method Selection & Shipment Label API is included in this documentation. For multi-parcel shipments, these required fields would be included in the multiParcelShipmentParameters.
Reference field | Required/Optional | Field properties | Description |
|---|---|---|---|
| Required | String | Carrier-provided identifier; this is the purchase order number from the order step via Amazon. |
| Required | String | Used to correlate parcels to label documents from the carrier; this is the container identifier that Amazon uses as a parcel identifier. |
| Required | Integer | A carrier-provided identifier that references the order item; this is the item sequence number returned from Amazon during the order placement step. |
| Required | String | A product ID for the product being checked; this is the vendor product identifier you received from Amazon in the purchase order. |
| Required | Integer | The number of units of this product |
| Required | Number | The value of the weight |
| Required | String enumeration
| The unit in which weight values are provided |
Resources
Your Shipium team member is available to help along the way. However, you might find these resources helpful:
Updated 4 days ago
