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.
Returns inbound guidance for a list of items by ASIN.
The GetInboundGuidanceForASIN operation lets a seller know if Amazon recommends sending a product to a given marketplace. In some cases, Amazon provides guidance for why a given ASIN is not recommended for shipment to Amazon's fulfillment network.
Sellers may still ship items that are not recommended, at their discretion.
This operation is available in all marketplaces except Brazil.
Maximum request quota | Restore rate | Hourly request quota |
---|---|---|
200 requests | 200 requests per second | 500 requests per hour |
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 |
---|---|---|---|
ASINList | A list of ASIN values. Used to identify items for which you want inbound guidance for shipment to Amazon's fulfillment network. | Yes | Maximum: 50 ASIN 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 |
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 GetInboundGuidanceForASIN operation are:
Name | Description | Required | Values |
---|---|---|---|
ASINInboundGuidanceList | A list of ASINs and their associated inbound guidance. | Yes | Type: List of ASINInboundGuidance |
InvalidASINList | A list of ASINs that were not found. | No | Type: List of xs:string |
For information about standard request requirements, see Required request parameters.
https://mws.amazonservices.com/FulfillmentInboundShipment/2010-10-01 ?AWSAccessKeyId=0PB842EXAMPLE7N4ZTR2 &Action=GetInboundGuidanceForASIN &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 &ASINList.Id.1=B00005N5PF &MarketplaceId=ATVPDKIKX0DER
For information about standard response formatting, see Response format.
<?xml version="1.0"?> <GetInboundGuidanceForASINResponse xmlns="https://mws.amazonservices.com/FulfillmentInboundShipment/2010-10-01"> <GetInboundGuidanceForASINResult> <ASINInboundGuidanceList> <ASIN>B00005N5PF</ASIN> <InboundGuidance>InboundNotRecommended</InboundGuidance> <GuidanceReasonList> <GuidanceReason>SlowMovingASIN</GuidanceReason> </GuidanceReasonList> </ASINInboundGuidanceList> <InvalidASINList></InvalidASINList> </GetInboundGuidanceForASINResult> <ResponseMetadata> <RequestId>d80c6c7b-f7c7-4fa7-bdd7-854711cb3bcc</RequestId> </ResponseMetadata> </GetInboundGuidanceForASINResponse>