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 IDDescription
AmazonShipping_USThe United States Amazon shipping business
AmazonShipping_INThe India Amazon shipping business
AmazonShipping_UKThe United Kingdom Amazon shipping business
AmazonShipping_ITThe Italy Amazon shipping business
AmazonShipping_ESThe Spain Amazon shipping business
AmazonShipping_FRThe France Amazon shipping business
AmazonShipping_JPThe 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 fieldRequired/OptionalField propertiesDescription
shipmentParameters .orderSourceNameRequiredStringThe source of the order that was placed; if the source is Amazon Marketplace, you'll enter amazon for this value.
shipmentParameters .carrierProcessingIdRequired if the value provided for orderSourceName is amazonStringCarrier-provided identifier; this is the purchase order number from the order step via Amazon.
shipmentParameters .orderItemQuantities .hazmatInfo .packingInstruction CodeRequired for international shipments and shipments containing hazardous materialsString enumeration
Values are:

- PI965_SECTION_IA (Ion PI965 Section IA [LiBa])
- PI965_SECTION_IB (Ion PI965 Section IB [LiBa])
- PI965_SECTION_II ( [LiBa])
- PI966_SECTION_I (Ion PI966 Section I [LiBa with equipment])
- PI966_SECTION_II (Ion PI966 Section II [LiBa with equipment])
- PI967_SECTION_I (Ion PI967 Section I [LiBa in equipment])
- PI967_SECTION_II(Ion PI967 Section II [LiBa in equipment])
- PI968_SECTION_IA (Metal PI968 Section IA [LiBa])
- PI968_SECTION_IB (Metal PI968 Section IB [LiBa])
- PI969_SECTION_I (Metal PI969 Section I [LiBa with equipment])
- PI969_SECTION_II (Metal PI969 Section II [LiBa with equipment])
- PI970_SECTION_I (Metal PI970 Section I [LiBa in equipment])
- PI970_SECTION_II (Metal PI970 Section II [LiBa in equipment])
The specific packing instruction of the item being shipped
shipmentParameters .orderItemQuantities .itemWeight.weightRequiredNumberThe value of the weight; this value may also be included in customsInfo.customsItems.customsWeight .weight
shipmentParameters .orderItemQuantities .itemWeight .weightUnitRequiredString enumeration
Values are:

- g (gram)
- kg (kilogram)
- oz (ounce)
- lb (pound)
The unit in which weight values are provided; this value may also be included in customsInfo.customsItems.customsWeight .weightUnit

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

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 fieldRequired/OptionalField propertiesDescription
shipmentParameters .carrierProcessingIdRequiredStringCarrier-provided identifier; this is the purchase order number from the order step via Amazon.
shipmentParameters .packageReference IdentifierRequiredStringUsed to correlate parcels to label documents from the carrier; this is the container identifier that Amazon uses as a parcel identifier.
shipmentParameters .orderItemQuantities .orderItemReference IdentifierRequiredIntegerA carrier-provided identifier that references the order item; this is the item sequence number returned from Amazon during the order placement step.
shipmentParameters .orderItemQuantities .productIdRequiredStringA product ID for the product being checked; this is the vendor product identifier you received from Amazon in the purchase order.
shipmentParameters .orderItemQuantities .quantityRequiredIntegerThe number of units of this product
shipmentParameters .packagingType .packagingWeight .weightRequiredNumberThe value of the weight
shipmentParameters .packagingType .packagingWeight .weightUnitRequiredString enumeration
Values are:

- g (gram)
- kg (kilogram)
- oz (ounce)
- lb (pound)
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: