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

Step 1 - Create a listing and convert it to FBA

If a product already exists in the Amazon catalog, creating a listing can be as simple as associating a unique seller-defined SKU with the unique Amazon-defined ASIN (Amazon Standard Item Number) for the product. If a product does not yet exist in the Amazon catalog, creating a listing requires providing descriptive information about the product so Amazon can build a record and assign an ASIN to the product. You can create listings by submitting feeds using the Feeds API section. See the following guidance for using XML or flat file feeds to create a listing and convert it to Fulfillment by Amazon (FBA).

Important: Before you can convert a listing to FBA you need to provide additional information on any products that are batteries, contain or are sold with batteries, or may be considered dangerous goods. Any attempt to convert a listing to FBA without providing battery and dangerous goods information will fail. See Provide battery and dangerous goods information.

Using XML feeds

You can create a listing and convert it to FBA by submitting XML feeds using the Feeds API section. See What you should know about the Amazon MWS Feeds API section.

To create a listing and convert it to FBA

  1. Submit the Product Feed (_POST_PRODUCT_DATA_).

    If the product is in Amazon's catalog, the feed should include:

    • The SKU element, containing to the seller's unique SKU for the product.
    • The StandardProductID element, containing values that uniquely identify the product in Amazon's catalog.
    • Battery and dangerous goods information, according to the guidance in Requirements for MWS Integrators (PDF).

    OR

    If the product is not yet in Amazon's catalog, the feed should include:

  2. Submit the Inventory Feed (_POST_INVENTORY_AVAILABILITY_DATA_). The feed should include:
    • The FulfillmentCenterID element, set to AMAZON_NA, AMAZON_EU, AMAZON_IN, or AMAZON_JP, depending on the seller's marketplace.
    • The Lookup element, set to FulfillmentNetwork.
    • The SwitchFulfillmentTo element, set to AFN.

For more information about feed types, see FeedType enumeration.

Using flat file feeds

You can create a listing and convert it to FBA by submitting flat file feeds using the Feeds API section. See What you should know about the Amazon MWS Feeds API section.

To create a listing and convert it to FBA (if the product is in Amazon's catalog)

  1. Submit the Flat File Inventory Loader Feed (_POST_FLAT_FILE_INVLOADER_DATA_). Alternatively, you can submit the Flat File Listings Loader Feed (_POST_FLAT_FILE_LISTINGS_DATA_). The feed should include:
    • The sku field, containing the seller's unique SKU for the product.
    • The product-id and product-id-type fields, containing values that uniquely identify the product in Amazon's catalog.
    • The fulfillment-center-id field, set to AMAZON_NA, AMAZON_EU, AMAZON_IN, or AMAZON_JP, depending on the seller's marketplace.
    • Battery and dangerous goods information, according to the guidance in Requirements for MWS Integrators (PDF)

To create a listing and convert it to FBA (if the product is not yet in Amazon's catalog)

  1. Submit an Inventory File Template. See the Download an Inventory File tab of the Add Products via Upload page of Seller Central.
    • Set the field values according to the instructions in the Inventory File Template.
  2. Submit the Flat File Inventory Loader Feed (_POST_FLAT_FILE_INVLOADER_DATA_). Alternatively, you can submit the Flat File Listings Loader Feed (_POST_FLAT_FILE_LISTINGS_DATA_). The feed should include:
    • The fulfillment-center-id field, set to AMAZON_NA, AMAZON_EU, AMAZON_IN, or AMAZON_JP, depending on the seller's marketplace.
    • Battery and dangerous goods information, according to the guidance in Requirements for MWS Integrators (PDF)

For more information about feed types, see FeedType enumeration.