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

GetInboundGuidanceForSKU

Returns inbound guidance for a list of items by Seller SKU.

Description

The GetInboundGuidanceForSKU operation lets a seller know if Amazon recommends sending an item to a given marketplace. In some cases, Amazon provides guidance for why a given Seller SKU is not recommended for shipment to Amazon's fulfillment network.

Sellers may still ship items that are not recommended, at their discretion.

Availability

This operation is available in all marketplaces except Brazil.

Throttling

Maximum request quota Restore rate Hourly request quota
200 requests 200 requests per second 500 requests per hour
For definitions of throttling terminology and for a complete explanation of throttling, see Throttling: Limits to how often you can submit requests in the Amazon MWS Developer Guide.

Request parameters

For more information about the request parameters that are required for all Amazon MWS operations, see Required request parameters in the Amazon MWS Developer Guide.

Name Description Required Values
SellerSKUList A list of SellerSKU values. Used to identify items for which you want inbound guidance for shipment to Amazon's fulfillment network. Yes Maximum: 50 SellerSKU values.

Type: xs:string

MarketplaceId A marketplace identifier. Specifies the marketplace where the product would be stored. Yes For a list of MarketplaceId values, see Amazon MWS endpoints and MarketplaceId values in the Amazon MWS Developer Guide.

Type: xs:string

Notes

  1. SellerSKU is qualified by your SellerId, which is included with every Amazon Marketplace Web Service (Amazon MWS) operation that you submit.
  2. If you specify a SellerSKU that identifies a variation parent ASIN, this operation returns the InvalidParamaterValue error. A variation parent ASIN represents a generic product that cannot be sold. Variation child ASINs represent products that have specific characteristics (such as size and color) and can be sold.

Response elements

Amazon MWS returns an XML file that contains the response to a successful request or subscription. If the request is unsuccessful, the main response element is ErrorResponse. For more information, see Response format in the Amazon MWS Developer Guide.

The top-level elements returned by the GetInboundGuidanceForSKU operation are:

GetInboundGuidanceForSKU Elements

Name Description Required Values
SKUInboundGuidanceList A list of Seller SKUs and their associated inbound guidance. Yes Type: List of SKUInboundGuidance
InvalidSKUList A list of Seller SKUs that were not found. No Type: List of xs:string

Examples

Example query request

For information about standard request requirements, see Required request parameters.

Show example code Hide example code

https://mws.amazonservices.com/FulfillmentInboundShipment/2010-10-01
  ?AWSAccessKeyId=0PB842EXAMPLE7N4ZTR2
  &Action=GetInboundGuidanceForSKU
  &MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE
  &SellerId=A1XEXAMPLE5E6
  &Signature=ZQLpf8vEXAMPLE0iC265pf18n0%3D
  &SignatureVersion=2
  &SignatureMethod=HmacSHA256
  &Timestamp=2016-09-26T18%3A12%3A21
  &Version=2010-10-01
  &SellerSKUList.Id.1=us001
  &MarketplaceId=ATVPDKIKX0DER

↑ Top

Example response (Success)

For information about standard response formatting, see Response format.

Show example code Hide example code

<?xml version="1.0"?>
<GetInboundGuidanceForSKUResponse
  xmlns="https://mws.amazonservices.com/FulfillmentInboundShipment/2010-10-01">
  <GetInboundGuidanceForSKUResult>
    <SKUInboundGuidanceList>
      <SellerSKU>us001</SellerSKU>
      <ASIN>B00005N5PF</ASIN>
      <InboundGuidance>InboundNotRecommended</InboundGuidance>
      <GuidanceReasonList>
        <GuidanceReason>SlowMovingASIN</GuidanceReason>
      </GuidanceReasonList>
    </SKUInboundGuidanceList>
    <InvalidSKUList></InvalidSKUList>
  </GetInboundGuidanceForSKUResult>
  <ResponseMetadata>
    <RequestId>d80c6c7b-f7c7-4fa7-bdd7-854711cb3bcc</RequestId>
  </ResponseMetadata>
</GetInboundGuidanceForSKUResponse>

↑ Top