Amazon Services
Amazon Marketplace Web Service (Amazon MWS) Documentation

Deprecation Notice:

Amazon Marketplace Web Service (MWS) will no longer be available after March 31, 2024. All MWS developers must migrate to Selling Partner API (SP-API) to avoid service disruptions. Refer to the Migration Hub for more information.

Amazon MWS Documentation

What you should know about the Merchant Fulfillment service

With the Merchant Fulfillment service, you can build applications that let sellers purchase shipping for non-Prime and Prime orders using Amazon’s Buy Shipping Services. To build applications that fulfill Prime orders, see How to fulfill Seller Fulfilled Prime orders.

You can build applications that can:

  • Preview shipping service offers based on shipping requirements: ship date, must arrive by date, package size and weight, etc.
  • Create shipments based on shipping service offers that they choose.
  • Automatically pay for shipping through the API service.
  • Receive and print shipping labels.
Important: Your access to Amazon MWS data depends on the role Amazon assigns you after you submit the Developer Registration and Assessment form. For more information see Registering to use Amazon MWS.

Terms and conditions

Before a seller can use any application that uses the Merchant Fulfillment service to fulfill orders, they need to:

  1. Review and accept the terms and conditions of the Buy Shipping Services program.
  2. Review and accept the terms and conditions of any carrier that they want to purchase shipping from.

Sellers can review and accept terms and conditions on the Manage Shipping Services page of Seller Central. Calling the Merchant Fulfillment service on behalf of a seller who has not accepted the terms and conditions of Amazon and the carrier returns the TermsAndConditionsNotAccepted error. See Error codes.

Operations

These operations are included in the Merchant Fulfillment service

Operation Description Availability
GetEligibleShippingServices Returns a list of shipping service offers. The Canada, US, MX, Spain, UK, France, Germany, Italy, and India marketplaces.
GetAdditionalSellerInputs Returns a list of additional seller inputs that are required from the seller to purchase the shipping service that you specify. The Canada, US, MX, Spain, UK, France, Germany, Italy, and India marketplaces.
CreateShipment Purchases shipping and returns a shipping label. The Canada, US, MX, Spain, UK, France, Germany, Italy, and India marketplaces.
GetShipment Returns an existing shipment for a given identifier. The Canada, US, MX, Spain, UK, France, Germany, Italy, and India marketplaces.
CancelShipment Cancels an existing shipment. The Canada, US, MX, Spain, UK, France, Germany, Italy, and India marketplaces.
GetServiceStatus Returns the operational status of the Merchant Fulfillment service. The Canada, US, MX, Spain, UK, France, Germany, Italy, and India marketplaces.

Terminology

Term Definition
Shipping service A carrier's shipping service. For example, "UPS Ground" or "FedEx Standard Overnight". Identified with a ShippingServiceId value, which is returned by the GetEligibleShippingServices operation.
Shipping service offer A shipping service offer made by a carrier. Represented by the ShippingService datatype. Identified with a ShippingServiceOfferId value, which is returned by the GetEligibleShippingServices operation.
Package A parcel to be shipped by a carrier. A package includes metadata such as dimensions, weight, and item contents.
Shipment A package and a shipping label. Identified with a ShipmentId value.
Additional seller inputs Additional seller-provided information that is required to purchase certain shipping services. You can call the GetAdditionalSellerInputs to find out which additional seller inputs are required for a specific shipping service. Then, after getting these additional seller inputs from the seller, you can use them as input to the CreateShipment operation to purchase the shipping service.