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

GetFulfillmentPreview

指定した出荷条件に基づき、出荷注文予測のリストを返します。

説明

GetFulfillmentPreviewは、指定した出荷条件に基づき、出荷注文予測リストを返します。各出荷注文予測には、見込まれる出荷注文の個々の出荷に対する出荷日、お届け日、出荷重量の見積もりに加え、見込まれる出荷注文の出荷重量と配送料の見積もりが含まれます。日本では、GetFulfillmentPreviewオペレーションは、FBAマルチチャネルサービスの出荷注文のお届け期間を任意で返します。また、このオペレーションは出荷注文予測に含まれる出荷不可能な商品の情報も返します。

注: 納品ステータスがWORKINGまたはSHIPPEDの場合、Amazonはその納品の商品は販売可能とみなします。すなわち、GetFulfillmentPreviewオペレーションは、Amazonフルフィルメントセンターに到着していない販売可能な商品の予測重量や予測配送料を返すことがあります。そのため、ステータスがWORKINGまたはSHIPPEDの納品商品に対する重量や配送料の予測は正しくない場合があります。

利用可否

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

スロットリング

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

リクエストパラメーター

名前 説明 必須
MarketplaceId 注文が行われたマーケットプレイス。 いいえ MarketplaceId値:Amazon MWSエンドポイントとMarketplaceId値を参照。

タイプ:xs:string

Address 出荷注文予測のお届け先住所。 はい タイプ: Address
Items 出荷注文予測に含まれる商品の識別情報や数量情報。 はい タイプ:リスト - GetFulfillmentPreviewItem
ShippingSpeedCategories 出荷注文予測の作成に使用される配送方法のリスト。 いいえ ShippingSpeedCategories値:
  • Standard - 通常配送
  • Expedited - お急ぎ便
  • Priority - 優先配送 (USのみ)
  • ScheduledDelivery - お届け日時指定便。お届け日時指定便は、日本(JP)のみでご利用いただけます。詳しくは、お届け日時指定を参照してください。
注: 利用できる配送スピードは、マーケットプレイスによって異なります。利用できる配送スピードとFBA手数料は、該当マーケットプレイスのAmazonセラーセントラルWebサイトで確認してください。
デフォルト:すべて

タイプ:タイプ:xs:string

IncludeCODFulfillmentPreview 代金引換(COD - Cash On Delivery)の出荷注文の予測を返すかどうかを指定します。 いいえ IncludeCODFulfillmentPreview値:
  • true - 代金引換、代金引換以外の両方を含むすべての出荷注文の予測を返します。
  • false - 代金引換以外の出荷注文の予測のみを返します。

デフォルト:false

注: IncludeCODFulfillmentPreviewは、日本(JP)と中国(CN)のみ有効なリクエストパラメーターです。その他のマーケットプレイスでは、IncludeCODFulfillmentPreviewリクエストパラメーターは無視されます。

タイプ:xs:boolean

IncludeDeliveryWindows お届け日時指定便に指定できるお届け期間をScheduledDeliveryInfoレスポンス要素で返すかどうかを指定します。ScheduledDeliveryInfoレスポンス要素は、出荷注文予測がShippingSpeedCategories =ScheduledDeliveryの場合にのみ返されます。 いいえ IncludeDeliveryWindows値:
  • true - ScheduledDeliveryInfoレスポンス要素を返します。
  • falseScheduledDeliveryInfoレスポンス要素を返しません。
注: IncludeDeliveryWindowsは、日本(JP)のみで有効なリクエストパラメーターです。その他のマーケットプレイスでは、IncludeDeliveryWindowsリクエストパラメーターは無視されます。

お届け日時指定便について詳しくは、お届け日時指定を参照してください。

デフォルト:false

タイプ:xs:boolean

レスポンス要素

名前 説明
FulfillmentPreviews 出荷注文予測の一覧で、出荷重量の見積もりや配送料の見積もり、出荷予定日、配送予定日を含む。

タイプ:リスト - FulfillmentPreview

クエリーリクエスト例

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

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

http://mws.amazonservices.jp/FulfillmentOutboundShipment/2010-10-01/   
  ?Action=GetFulfillmentPreview   
  &Version=2010-10-01   
  &AWSAccessKeyId=AKIAJGUEXAMPLEE2NVUA   
  &MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE   
  &SignatureVersion=2   
  &SignatureMethod=HmacSHA256
  &Signature=ZRA9DR5rveSuz%2F1D18AHvoipg2BAev8yblPQ1BbEbfU%3D   
  &Timestamp=2014-01-02T02:40:36Z   
  &SellerId=A2NKEXAMPLEF53   
  &MarketplaceId=ATVPDKIKX0DER
  &Address.Name=Amazon%20Taro   
  &Address.Line1=Meguro-ku%20Shimomeguro%2012-34-56   
  &Address.Line2=XXX%20building%20101   
  &Address.StateOrProvinceCode=Tokyo   
  &Address.PostalCode=1500002   
  &Address.CountryCode=JP
  &Items.member.1.Quantity=1   
  &Items.member.1.SellerFulfillmentOrderItemId=TestId1   
  &Items.member.1.SellerSKU=SampleSKU1   
  &Items.member.2.Quantity=2   
  &Items.member.2.SellerFulfillmentOrderItemId=TestId2   
  &Items.member.2.SellerSKU=SampleSKU2  
  &ShippingSpeedCategories.1=Expedited   
  &ShippingSpeedCategories.2=Standard   
  &ShippingSpeedCategories.3=ScheduledDelivery      
  &IncludeCODFulfillmentPreview=true   
  &IncludeDeliveryWindows=true     

↑ トップへ戻る

レスポンス例

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

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

<?xml version="1.0"?>
  <GetFulfillmentPreviewResponse
      xmlns="http://mws.amazonaws.com/FulfillmentInboundShipment/2010-10-01/">
    <GetFulfillmentPreviewResult>
      <FulfillmentPreviews>
        <member>         
          <EstimatedShippingWeight>
            <Unit>kilograms</Unit>
            <Value>12</Value>
          </EstimatedShippingWeight>
          <ShippingSpeedCategory>Expedited</ShippingSpeedCategory>
          <FulfillmentPreviewShipments>
            <member>
              <LatestShipDate>2014-01-04T00:30:00Z</LatestShipDate>
              <LatestArrivalDate>2014-01-06T06:59:59Z</LatestArrivalDate>
              <FulfillmentPreviewItems>
                <member>
                  <EstimatedShippingWeight>
                    <Unit>kilograms</Unit>
                    <Value>10</Value>
                  </EstimatedShippingWeight>
                  <SellerSKU>SampleSKU1</SellerSKU>
                  <SellerFulfillmentOrderItemId>
                  mws-test-query-20100713023406723-2
                  </SellerFulfillmentOrderItemId>
                  <ShippingWeightCalculationMethod>Package
                  </ShippingWeightCalculationMethod>
                  <Quantity>2</Quantity>
                </member>
                <member>
                  <EstimatedShippingWeight>
                    <Unit>kilograms</Unit>
                    <Value>2</Value>
                  </EstimatedShippingWeight>
                  <SellerSKU>SampleSKU2</SellerSKU>
                  <SellerFulfillmentOrderItemId>
                  mws-test-query-20100713023406723-1
                  </SellerFulfillmentOrderItemId>
                  <ShippingWeightCalculationMethod>Package
                  </ShippingWeightCalculationMethod>
                  <Quantity>1</Quantity>
                </member>
              </FulfillmentPreviewItems>
              <EarliestShipDate>2014-01-04T00:30:00Z</EarliestShipDate>
              <EarliestArrivalDate>2014-01-05T07:00:00Z
              </EarliestArrivalDate>
            </member>
          </FulfillmentPreviewShipments>
          <EstimatedFees>
            <member>
              <Amount>
                <CurrencyCode>JPY</CurrencyCode>
                <Value>225</Value>
              </Amount>
              <Name>FBAPerUnitFulfillmentFee</Name>
            </member>
            <member>
              <Amount>
                <CurrencyCode>JPY</CurrencyCode>
                <Value>475</Value>
              </Amount>
              <Name>FBAPerOrderFulfillmentFee</Name>
            </member>
            <member>
              <Amount>
                <CurrencyCode>JPY</CurrencyCode>
                <Value>660</Value>
              </Amount>
              <Name>FBATransportationFee</Name>
            </member>
          </EstimatedFees>
          <UnfulfillablePreviewItems/>
          <IsFulfillable>true</IsFulfillable>
          <IsCODCapable>false</IsCODCapable>
          <MarketplaceId>ATVPDKIKX0DER</MarketplaceId>
        </member>
        <member>
          <EstimatedShippingWeight>
            <Unit>kilograms</Unit>
            <Value>12</Value>
          </EstimatedShippingWeight>
          <ShippingSpeedCategory>Standard</ShippingSpeedCategory>
          <FulfillmentPreviewShipments>
            <member>
              <LatestShipDate>2014-01-04T00:30:00Z</LatestShipDate>
              <LatestArrivalDate>2014-07-09T06:59:59Z</LatestArrivalDate>
              <FulfillmentPreviewItems>
                <member>
                  <EstimatedShippingWeight>
                    <Unit>kilograms</Unit>
                    <Value>10</Value>
                  </EstimatedShippingWeight>
                  <SellerSKU>SampleSKU1</SellerSKU>
                  <SellerFulfillmentOrderItemId>
                  mws-test-query-20100713023406723-2
                  </SellerFulfillmentOrderItemId>
                  <ShippingWeightCalculationMethod>Package
                  </ShippingWeightCalculationMethod>
                  <Quantity>2</Quantity>
                </member>
                <member>
                  <EstimatedShippingWeight>
                    <Unit>kilograms</Unit>
                    <Value>2</Value>
                  </EstimatedShippingWeight>
                  <SellerSKU>SampleSKU2</SellerSKU>
                  <SellerFulfillmentOrderItemId>
                  mws-test-query-20100713023406723-1
                  </SellerFulfillmentOrderItemId>
                  <ShippingWeightCalculationMethod>Package
                  </ShippingWeightCalculationMethod>
                  <Quantity>1</Quantity>
                </member>
              </FulfillmentPreviewItems>
              <EarliestShipDate>2014-01-04T00:30:00Z</EarliestShipDate>
              <EarliestArrivalDate>2014-01-05T07:00:00Z
              </EarliestArrivalDate>
            </member>
          </FulfillmentPreviewShipments>
          <EstimatedFees>
            <member>
              <Amount>
                <CurrencyCode>JPY</CurrencyCode>
                <Value>225</Value>
              </Amount>
              <Name>FBAPerUnitFulfillmentFee</Name>
            </member>
            <member>
              <Amount>
                <CurrencyCode>JPY</CurrencyCode>
                <Value>475</Value>
              </Amount>
              <Name>FBAPerOrderFulfillmentFee</Name>
            </member>
            <member>
              <Amount>
                <CurrencyCode>JPY</CurrencyCode>
                <Value>660</Value>
              </Amount>
              <Name>FBATransportationFee</Name>
            </member>
            <member>
              <Amount>
                <CurrencyCode>JPY</CurrencyCode>
                <Value>315</Value>
              </Amount>
              <Name>FBAFulfillmentCODFee</Name>
            </member>
          </EstimatedFees>
          <UnfulfillablePreviewItems/>
          <IsFulfillable>true</IsFulfillable>
          <IsCODCapable>true</IsCODCapable>
        </member>
        <member>
          <EstimatedShippingWeight>
            <Unit>kilograms</Unit>
            <Value>12</Value>
          </EstimatedShippingWeight>
          <ShippingSpeedCategory>ScheduledDelivery</ShippingSpeedCategory>
          <ScheduledDeliveryInfo>
            <DeliveryTimeZone>Asia/Tokyo</DeliveryTimeZone>
            <DeliveryWindows>
              <member>
                <DeliveryWindow>
                  <StartDateTime>2014-01-04T23:00:00Z</StartDateTime>
                  <EndDateTime>2014-01-05T03:00:00Z</EndDateTime>
                </DeliveryWindow>
              </member>
              <member>
                <DeliveryWindow>
                  <StartDateTime>2014-01-05T03:00:00Z</StartDateTime>
                  <EndDateTime>2014-01-05T05:00:00Z</EndDateTime>
                </DeliveryWindow>
              </member>
              <member>
                <DeliveryWindow>
                  <StartDateTime>2014-01-05T05:00:00Z</StartDateTime>
                  <EndDateTime>2014-01-05T07:00:00Z</EndDateTime>
                </DeliveryWindow>
              </member>
              <member>
                <DeliveryWindow>
                  <StartDateTime>2014-01-05T07:00:00Z</StartDateTime>
                  <EndDateTime>2014-01-05T09:00:00Z</EndDateTime>
                </DeliveryWindow>
              </member>
              <member>
                <DeliveryWindow>
                  <StartDateTime>2014-01-05T09:00:00Z</StartDateTime>
                  <EndDateTime>2014-01-05T11:00:00Z</EndDateTime>
                </DeliveryWindow>
                </member>
              <member>
                <DeliveryWindow>
                  <StartDateTime>2014-01-05T11:00:00Z</StartDateTime>
                  <EndDateTime>2014-01-05T12:00:00Z</EndDateTime>
                </DeliveryWindow>
              </member>
              <member>
                <DeliveryWindow>
                  <StartDateTime>2014-01-05T23:00:00Z</StartDateTime>
                  <EndDateTime>2014-01-06T03:00:00Z</EndDateTime>
                </DeliveryWindow>
              </member>
              <member>
                <DeliveryWindow>
                  <StartDateTime>2014-01-06T03:00:00Z</StartDateTime>
                  <EndDateTime>2014-01-06T05:00:00Z</EndDateTime>
                </DeliveryWindow>
              </member>
              <member>
                <DeliveryWindow>
                  <StartDateTime>2014-01-06T05:00:00Z</StartDateTime>
                  <EndDateTime>2014-01-06T07:00:00Z</EndDateTime>
                </DeliveryWindow>
              </member>
              <member>
                <DeliveryWindow>
                  <StartDateTime>2014-01-06T07:00:00Z</StartDateTime>
                  <EndDateTime>2014-01-06T09:00:00Z</EndDateTime>
                </DeliveryWindow>
              </member>
              <member>
                <DeliveryWindow>
                  <StartDateTime>2014-01-06T09:00:00Z</StartDateTime>
                  <EndDateTime>2014-01-06T11:00:00Z</EndDateTime>
                </DeliveryWindow>
              </member>
              <member>
                <DeliveryWindow>
                  <StartDateTime>2014-01-06T11:00:00Z</StartDateTime>
                  <EndDateTime>2014-01-06T12:00:00Z</EndDateTime>
                </DeliveryWindow>
              </member>
            </DeliveryWindows>
          </ScheduledDeliveryInfo>
          <FulfillmentPreviewShipments>
            <member>
              <LatestShipDate>2014-01-04T00:30:00Z</LatestShipDate>
              <LatestArrivalDate>2014-01-06T06:59:59Z</LatestArrivalDate>
              <FulfillmentPreviewItems>
                <member>
                  <EstimatedShippingWeight>
                    <Unit>kilograms</Unit>
                    <Value>10</Value>
                  </EstimatedShippingWeight>
                  <SellerSKU>SampleSKU1</SellerSKU>
                  <SellerFulfillmentOrderItemId>
                  mws-test-query-20100713023406723-2
                  </SellerFulfillmentOrderItemId>
                  <ShippingWeightCalculationMethod>Package
                  </ShippingWeightCalculationMethod>
                  <Quantity>2</Quantity>
                </member>
                <member>
                  <EstimatedShippingWeight>
                    <Unit>kilograms</Unit>
                    <Value>2</Value>
                  </EstimatedShippingWeight>
                  <SellerSKU>SampleSKU2</SellerSKU>
                  <SellerFulfillmentOrderItemId>
                  mws-test-query-20100713023406723-1
                  </SellerFulfillmentOrderItemId>
                  <ShippingWeightCalculationMethod>Package
                  </ShippingWeightCalculationMethod>
                  <Quantity>1</Quantity>
                </member>
              </FulfillmentPreviewItems>
              <EarliestShipDate>2014-01-04T00:30:00Z</EarliestShipDate>
              <EarliestArrivalDate>2014-01-05T07:00:00Z
              </EarliestArrivalDate>
            </member>
          </FulfillmentPreviewShipments>
          <EstimatedFees>
            <member>
              <Amount>
                <CurrencyCode>JPY</CurrencyCode>
                <Value>225</Value>
              </Amount>
              <Name>FBAPerUnitFulfillmentFee</Name>
            </member>
            <member>
              <Amount>
                <CurrencyCode>JPY</CurrencyCode>
                <Value>475</Value>
              </Amount>
              <Name>FBAPerOrderFulfillmentFee</Name>
            </member>
            <member>
              <Amount>
                <CurrencyCode>JPY</CurrencyCode>
                <Value>660</Value>
              </Amount>
              <Name>FBATransportationFee</Name>
            </member>
          </EstimatedFees>
          <UnfulfillablePreviewItems/>
          <IsFulfillable>true</IsFulfillable>
          <IsCODCapable>false</IsCODCapable>
        </member>
      </FulfillmentPreviews>
    </GetFulfillmentPreviewResult>
    <ResponseMetadata>
      <RequestId>f4c29ec4-ceb7-4608-a764-5c758ac0021a</RequestId>
    </ResponseMetadata>
  </GetFulfillmentPreviewResponse>

↑ トップへ戻る