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

How to fulfill Seller Fulfilled Prime orders

Amazon recommends this workflow for using the Merchant Fulfillment service to fulfill Seller Fulfilled Prime orders. This workflow is meant to supplement an order fulfillment system that retrieves scheduled order reports using the Reports service. See Working with order reports. Incoming orders that are not fulfilled using the workflow described here must be fulfilled by the seller using some other method.

Important: This success of this workflow requires that incoming order reports contain the optional IsPrime and LatestShipDate elements (for XML order reports) or the optional is-prime and latest-ship-date fields (for flat file order reports). If these elements or fields do not appear in a seller's order reports, Prime orders cannot be identified and ship dates cannot be determined. This could lead to sellers missing the shipping SLAs for their Prime orders. Sellers using an application that you develop based on this workflow must add these columns to their order reports using the Optional columns area of the Add or remove order report columns in Seller Central.

For definitions, see Terminology.

To fulfill Seller Fulfilled Prime orders

  1. Identify Prime orders

    Identify the Prime orders in incoming order reports. Prime orders have the IsPrime element (for XML order reports) or the is-prime column (for flat file order reports) marked as true.

    Do not use the FulfillmentServiceLevel element or the ship-service-level column in order reports to attempt to identify Prime orders.

  2. Determine the latest ship date for the Prime orders

    Use the LatestShipDate element (from an XML order report) or the latest-ship-date column (from a flat file order report) to determine the date by which Prime orders need to be shipped.

  3. Get shipping service offers

    Call the GetEligibleShippingServices operation to get shipping service offers for the Prime orders identified in Step 1.

    • For the ShipDate parameter, use the LatestShipDate value (XML report) or the latest-ship-date value (flat file report) from the order report.
    • Do not specify the MustArriveByDate parameter, as this will unnecessarily limit the number of shipping service offers that are returned.
    • Save the ShippingServiceId value from each shipping service offer that is returned. Use this for subsequent calls to the CreateShipment operation to create shipments for specific shipping service offers.
  4. Create a shipment

    Call the CreateShipment operation for one of the shipping service offers returned in the previous step. Use these parameter values:

    • ShipmentRequestDetails. Use the same values that were included in the call to the GetEligibleShippingServices operation in the previous step.
    • ShippingServiceId. Use the value associated with this shipping service offer.
    Calling the CreateShipment operation:
    • Triggers payment for shipping, which is deducted from the seller’s Amazon seller account.
    • Confirms the shipment. The seller does not have to confirm the shipment by other means.
    Important: Save the ShipmentId value returned by the CreateShipment operation to identify the shipment in case the seller wants to print a new label, cancel a shipment, or check shipment status at a later time. Consider saving the item list along with each shipment ID to help the seller identify a shipment at a later time. See How to reprint a shipping label and How to cancel a shipment.
  5. Extract and print the shipping label

    Extract the shipping label from the FileContents element returned by the CreateShipment operation. Print the shipping label. See How to extract a shipping label file.

  6. Create shipments for the remaining Prime orders

    Repeat steps 3 through 5 until you have created shipments for all of the Prime orders identified in Step 1.