Amazon Services Japan
Amazonマーケットプレイス Web サービス (Amazon MWS) ドキュメント

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 ドキュメント

ListInboundShipments

指定した条件に基づき、納品のリストを返します。

説明

ListInboundShipmentsオペレーションは、指定したリクエストパラメーターに基づき、納品のリストを返します。ShipmentIdListリクエストパラメーターを使用して、ShipmentIdの値によって納品をリクエストできます。また、納品ステータスや最終更新日時に基づいた納品もリクエストできます。

ShipmentIdはCreateInboundShipmentPlanオペレーションを送信することにより作成され、納品プロセスを通じて納品の主要なIDとなります。

ListInboundShipmentsオペレーションで返される納品は最大50件です。納品の続きがある場合、NextTokenがレスポンスで返されます。すべての納品を取得するには、NextTokenの値をListInboundShipmentsByNextTokenオペレーションに渡し、NextTokenが返されなくなるまで繰り返します。

利用可否

このオペレーションはすべてのマーケットプレイスで利用できます。

スロットリング

ListInboundShipmentsおよびListInboundShipmentsByNextTokenオペレーションはいずれも、最大リクエストクォータが30リクエストで、回復レートが毎秒2リクエストです。 スロットリング用語の定義およびスロットリングの詳しい説明については、Amazon MWS開発者ガイドのスロットリング: リクエストを送信できる頻度を制限するを参照してください。

リクエストパラメーター

すべてのAmazon MWSオペレーションに必須とされるリクエストパラメーターについて詳しくは、Amazon MWS開発者ガイドの必須リクエストパラメータを参照してください。

名前 説明 必須 値
ShipmentStatusList ShipmentStatusの値のリスト。現在のステータスが指定したステータス値と一致する納品を選択するために使用する。 ShipmentIdListを指定しない場合は必須。

ShipmentStatusListおよびShipmentIdListの両方を指定した場合、両パラメーターが一致する納品のみ返される。

ShipmentStatus値：
  • WORKING - 出品者により納品は作成されたが、まだ納品商品が発送されていない状態。
  • SHIPPED - 配送業者により集荷された状態。
  • IN_TRANSIT - 配送業者が商品の受け取りをAmazonフルフィルメントセンターに通知した状態。
  • DELIVERED - 配送業者によりAmazonフルフィルメントセンターへの配送が完了した状態。
  • CHECKED_IN - Amazonフルフィルメントセンターの受領エリアに荷物が搬入された状態。
  • RECEIVING - 商品がAmazonフルフィルメントセンターに到着したが、全商品の受領は完了していない状態。
  • CLOSED - 商品がAmazonフルフィルメントセンターに到着し、全商品の受領が完了している状態。
  • CANCELLED - 商品がAmazonフルフィルメントセンターに発送された後に、出品者が納品をキャンセルした状態。
  • DELETED - 商品がAmazonフルフィルメントセンターに発送される前に、出品者が納品をキャンセルした状態。
  • ERROR - 納品にエラーがあり、Amazonで処理できない状態。

タイプ：タイプ：xs:string
ShipmentIdList ShipmentIdの値のリスト。指定したShipmentIdの値と一致するShipmentIdを持つ納品を選択するために使用する。 ShipmentStatusListを指定しない場合は必須。

ShipmentStatusListおよびShipmentIdListの両方を指定した場合、両パラメーターが一致する納品のみ返される。

タイプ：タイプ：xs:string
LastUpdatedAfter ある日付以降に最終更新された納品を選択するために指定する日付。この選択結果には、Amazonおよび出品者による更新が含まれる。 いいえ

LastUpdatedBeforeを指定した場合、LastUpdatedAfterを指定する必要がある。

LastUpdatedBeforeより前である必要がある。

ISO 8601日時フォーマット。

タイプ：xs:dateTime
LastUpdatedBefore ある日付以前に最終更新された納品を選択するために指定する日付。この選択結果には、Amazonおよび出品者による更新が含まれる。 いいえ

LastUpdatedAfterを指定した場合、LastUpdatedBeforeを指定する必要がある。

LastUpdatedAfterより後である必要がある。

ISO 8601日時フォーマット。

タイプ：xs:dateTime

レスポンス要素

名前 説明
NextToken 次のリクエストへの情報引き渡しに使用するために生成された文字列。NextTokenが返された場合、NextTokenの値をListInboundShipmentsByNextTokenに渡します。NextTokenが返されない場合、これ以上返される納品はありません。

任意

タイプ：xs:string
ShipmentData 出品者の納品情報。ShipmentDataレスポンス要素は商品情報を含まない。

タイプ： InboundShipmentInfo

例

クエリーリクエスト例

標準のリクエスト要件について詳しくは、必須のリクエストパラメーターを参照してください。

サンプルを表示するサンプルを隠す

http://mws.amazonaws.com/FulfillmentInboundShipment/2010-10-01
  ?AWSAccessKeyId=AKIAJGUVGFGHNKE2NVUA
  &Action=ListInboundShipments
  &MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE
  &SignatureVersion=2
  &Timestamp=2015-12-02T02:40:36Z
  &Version=2010-10-01
  &Signature=COwchWurFSmkpQ9OOCoZy5THApVmrpf0mtyxk5ShtrI%3D
  &SignatureMethod=HmacSHA256
  &ShipmentStatusList.member.1=WORKING
  &SellerId=A2NKEXAMPLEF53
  &LastUpdatedAfter=2015-10-02T12%3A00%3A54Z
  $LastUpdatedBefore=2015-11-02T12%3A00%3A54Z
  &ShipmentStatusList.member.2=CLOSED
  &ShipmentIdList.member.1=FBA44JV8R
  &ShipmentIdList.member.2=FBA4X8YLS
  &ShipmentIdList.member.3=FBA4X9FML

↑ トップへ戻る

レスポンス例

標準のレスポンスフォーマットについて詳しくは、レスポンスフォーマットを参照してください。

サンプルを表示するサンプルを隠す

<?xml version="1.0"?>
<ListInboundShipmentsResponse
    xmlns="http://mws.amazonaws.com/FulfillmentInboundShipment/2010-10-01/">
    <ListInboundShipmentsResult>
        <ShipmentData>
            <member>
                <ShipFromAddress>
                    <PostalCode>V5V 1A1</PostalCode>
                    <Name>jsowprni Devo CA20</Name>
                    <CountryCode>CA</CountryCode>
                    <StateOrProvinceCode>BC</StateOrProvinceCode>
                    <AddressLine1>Address Line 1</AddressLine1>
                    <City>Vancouver</City>
                </ShipFromAddress>
                <ShipmentId>FBAN4QNH</ShipmentId>
                <ShipmentName>FBA (8/27/12 1:55 PM)</ShipmentName>
                <ShipmentStatus>WORKING</ShipmentStatus>
                <LabelPrepType>NO_LABEL</LabelPrepType>
                <DestinationFulfillmentCenterId>YYZ1</DestinationFulfillmentCenterId>
            </member>
            <member>
                <ShipFromAddress>
                    <PostalCode>V5V 1A1</PostalCode>
                    <Name>Janani Arvind FBA QA</Name>
                    <CountryCode>CA</CountryCode>
                    <StateOrProvinceCode>BC</StateOrProvinceCode>
                    <AddressLine1>Address 1</AddressLine1>
                    <City>Vancouver</City>
                </ShipFromAddress>
                <ShipmentId>FBA1123</ShipmentId>
                <ShipmentName>Test MWS CA Shipment 1</ShipmentName>
                <ShipmentStatus>WORKING</ShipmentStatus>
                <LabelPrepType>NO_LABEL</LabelPrepType>
                <DestinationFulfillmentCenterId>RIC2</DestinationFulfillmentCenterId>
                <BoxContentsSource>NONE</BoxContentsSource>
                <EstimatedBoxContentsFee>
                    <TotalUnits>10</TotalUnits>
                    <FeePerUnit>
                        <CurrencyCode>USD</CurrencyCode>
                        <Value>0.10</Value>
                    </FeePerUnit>
                    <TotalFee>
                        <CurrencyCode>USD</CurrencyCode>
                        <Value>10.0</Value>
                    </TotalFee>
                </EstimatedBoxContentsFee>
            </member>
        </ShipmentData>
    </ListInboundShipmentsResult>
</ListInboundShipmentsResponse>

↑ トップへ戻る