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

CreateFulfillmentOrder

出品者のAmazonフルフィルメントネットワークの在庫からお届け先の住所へ商品を出荷するようAmazonに依頼します。

説明

CreateFulfillmentOrderオペレーションは、AmazonがAmazonフルフィルメントネットワークに保管されている出品者の在庫から商品を指定された住所に出荷するリクエストを生成します。
注: Amazonフルフィルメントネットワークに十分な在庫数がない場合に出荷注文を作成しようとすると、エラーが返されます。

出荷注文の出荷を保留にする

CreateFulfillmentOrderオペレーションを使用して、支払いの確認待ちなどの理由で出荷を遅らせたい場合に、出荷注文を保留の状態にすることができます。出荷注文を保留にすると、出荷を差し止められるだけではなく、Amazonサイトからのフルフィルメント by Amazon(FBA)注文に在庫が使われてしまうことを防ぎます。また、AmazonサイトとFBAマルチチャネルサービスを利用している他の販売経路の両方で、FBA在庫の売り越しを防ぐことができます。

出荷注文を作成して保留の状態にするには、CreateFulfillmentOrderオペレーションを呼び出し、FulfillmentAction = Holdを指定します。保留されている出荷注文を出荷、または更新するには、UpdateFulfillmentOrderを参照してください。

注: 保留状態は2週間続きます。2週間が経過し、出荷注文を出荷、またはキャンセルしていない場合は、自動的にキャンセルされます。商品は出品者の在庫に戻され、AmazonサイトのFBA注文に使用できるようになります。

利用可否

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

DeliveryWindowパラメーターは日本限定です。

スロットリング

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

リクエストパラメーター

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

タイプ:xs:string

SellerFulfillmentOrderId 出品者が出荷注文を追跡するために作成する出荷注文番号。SellerFulfillmentOrderIdには、作成した出荷注文ごとに一意の番号を割り当ててください。出品者のシステムですでに一意な注文IDを作成している場合、それをSellerFulfillmentOrderId値として使用できます。 はい 最大:40文字

タイプ:xs:string

FulfillmentAction 出荷注文を直ちに出荷するのか、それとも保留にするのかを指定します。 いいえ FulfillmentAction値:
  • Ship - 注文された商品を直ちに出荷。
  • Hold - 注文の出荷を保留。

デフォルト:Ship

タイプ:xs:string

DisplayableOrderId 出品者が作成した出荷注文識別番号。この値は、納品書など受取人が確認する文書に注文番号として表示されます。DisplayableOrderIdの値は、購入者に表示される注文番号と一致させてください。この値にSellerFulfillmentOrderIdを使用するか、または購入者に別の注文番号を提供する場合は、任意の番号を指定することができます。 はい 1文字から40文字までの英数字、またはISO 8859-1準拠の文字列。1行内にスペースを2つ含めることはできません。文字列の最初と最後のスペースは削除されます。

タイプ:xs:string

DisplayableOrderDateTime 出品者の出荷注文の日付。納品書など受取人が確認する書類に注文日として表示されます。 はい ISO 8601日時フォーマット

タイプ:xs:dateTime

DisplayableOrderComment 納品書など受取人が確認する書類に表示される注文に特化したテキスト。 はい 最大:1000文字

タイプ:xs:string

ShippingSpeedCategory 出荷注文の配送スピード。 はい ShippingSpeedCategory値:
  • Standard - 通常配送
  • Expedited - お急ぎ便
  • Priority - 優先配送 (USのみ)
  • ScheduledDelivery - お届け日時指定便。お届け日時指定便は、日本(JP)のみでご利用いただけます。詳しくは、お届け日時指定を参照してください。
注: 利用できる配送スピードは、マーケットプレイスによって異なります。利用できる配送スピードとFBA手数料は、該当マーケットプレイスのAmazonセラーセントラルWebサイトで確認してください。

タイプ:xs:string

DestinationAddress 出荷注文のお届け先住所。 はい タイプ: Address
FulfillmentPolicy 出荷注文に含まれている出荷不可商品をどのように扱うかを示します。 いいえ FulfillmentPolicy値:
  • FillOrKill - 出荷注文の出荷の一部がPendingステータスになる(すなわち在庫のピッキングプロセスが開始する)前に、その注文商品の一部が出荷不可になった場合、注文全体が出荷不可とみなされる。しかし、出荷注文の出荷の一部がPendingステータスになった後に、その注文の商品の一部が出荷不可になった場合、Amazonはその注文の出荷を極力キャンセルする。出荷ステータスの定義については、FulfillmentShipmentデータタイプをご覧ください。
  • FillAll - 出荷注文の出荷可能な商品がすべて出荷された状態。すべての商品がAmazonによって出荷されるか、出品者によりキャンセルされるまで、注文は処理中になる。
  • FillAllAvailable - 出荷注文の出荷可能な商品がすべて出荷された状態。注文に含まれる出荷不可能なすべての商品はAmazonによってキャンセルされている。

デフォルト:FillOrKill

タイプ:xs:string

NotificationEmailList Amazonが出品者の代わりに出荷通知を購入者に送信する際に使用する、出品者が提供したEメールアドレス。 いいえ 最大:Eメールアドレス1件につき64文字

タイプ:タイプ:xs:string

CODSettings 代金引換(COD - Cash On Delivery)注文の手数料。 いいえ CODSettingsリクエストパラメーターは、日本(JP)と中国(CN)のみ有効。日本(JP)と中国(CN)以外のマーケットプレイスでCODSettingsを指定すると、エラーが返されます。

タイプ: CODSettings

Items 出荷注文の予測に含まれる商品のリストとその数量。 はい タイプ:リスト - CreateFulfillmentOrderItem
DeliveryWindow お届け日時指定便の出荷注文に、お届け日時を指定します。
重要:
  • DeliveryWindowリクエストパラメーターのStartDateTimeEndDateTimeの値は、GetFulfillmentPreviewオペレーションの前回の呼び出しで返された値と正確に一致させる必要があります。GetFulfillmentPreviewオペレーションに対する前回の呼び出しで返されなかったStartDateTimeおよびEndDateTimeの値を指定した場合、サービスはエラーを返します。
  • GetFulfillmentPreviewオペレーションを呼び出した際に指定可能だったお届け期間は、CreateFulfillmentOrderオペレーション呼び出し時に指定できなくなる場合があります。この場合、エラーが返されます。GetFulfillmentPreviewオペレーションを再度呼び出し、現在指定可能なお届け期間を取得する必要があります。

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

いいえ。ShippingSpeedCategory =ScheduledDeliveryの場合のみ必須。 DeliveryWindowリクエストパラメーターは日本(JP)のみに有効です。日本(JP)以外のマーケットプレイスでDeliveryWindowを指定すると、エラーが返されます。

タイプ: DeliveryWindow

レスポンス要素

このオペレーションでは標準のレスポンス要素のみが返されます。

クエリーリクエスト例

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

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

http://mws.amazonservices.jp/FulfillmentOutboundShipment/2010-10-01/   
  ?Action=CreateFulfillmentOrder   
  &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
  &SellerFulfillmentOrderId=mws-test-query-20100713023203751   
  &DisplayableOrderId=mws-test-query-20100713023203751   
  &ShippingSpeedCategory=ScheduledDelivery   
  &DeliveryWindow.StartDateTime=2014-01-03T03:00:00Z   
  &DeliveryWindow.EndDateTime=2014-01-03T05:00:00Z   
  &DestinationAddress.Name=Amazon%20Taro   
  &DestinationAddress.Line1=Meguro-ku%20Shimomeguro%2012-34-56   
  &DestinationAddress.Line2=XXX%20building%20101   
  &DestinationAddress.CountryCode=JP   
  &DestinationAddress.StateOrProvinceCode=Tokyo   
  &DestinationAddress.PostalCode=1500002   
  &DisplayableOrderComment=Seller%20comment%20here   
  &DisplayableOrderDateTime=2013-12-29   
  &FulfillmentAction=Hold   
  &CODSettings.IsCODRequired=true   
  &CODSettings.CODCharge.CurrencyCode=JPY   
  &CODSettings.CODCharge.Value=10.00   
  &CODSettings.CODChargeTax.CurrencyCode=JPY   
  &CODSettings.CODChargeTax.Value=2.00   
  &CODSettings.ShippingCharge.CurrencyCode=JPY   
  &CODSettings.ShippingCharge.Value=5.00   
  &CODSettings.ShippingChargeTax.CurrencyCode=JPY   
  &CODSettings.ShippingChargeTax.Value=3.00   
  &Items.member.1.DisplayableComment=Seller%20comment%20here   
  &Items.member.1.GiftMessage=Gift%20comment%20here   
  &Items.member.1.PerUnitDeclaredValue.CurrencyCode=JPY   
  &Items.member.1.PerUnitDeclaredValue.Value=30   
  &Items.member.1.PerUnitPrice.CurrencyCode=JPY   
  &Items.member.1.PerUnitPrice.Value=40.00   
  &Items.member.1.PerUnitTax.CurrencyCode=JPY   
  &Items.member.1.PerUnitTax.Value=2.00   
  &Items.member.1.Quantity=1   
  &Items.member.1.SellerFulfillmentOrderItemId=mws-test-1   
  &Items.member.1.SellerSKU=Sample_SKU_1   
  &Items.member.2.DisplayableComment=Seller%20comment%20here   
  &Items.member.2.GiftMessage=Gift%20comment%20here   
  &Items.member.2.PerUnitDeclaredValue.CurrencyCode=JPY   
  &Items.member.2.PerUnitDeclaredValue.Value=20.00   
  &Items.member.2.PerUnitPrice.CurrencyCode=JPY   
  &Items.member.2.PerUnitPrice.Value=22.00   
  &Items.member.2.PerUnitTax.CurrencyCode=JPY   
  &Items.member.2.PerUnitTax.Value=6.00   
  &Items.member.2.Quantity=2   
  &Items.member.2.SellerFulfillmentOrderItemId=mws-test-2   
  &Items.member.2.SellerSKU=Sample_SKU_2   
  &NotificationEmailList.member.1=test1%40amazon.com   
  &NotificationEmailList.member.2=test2%40amazon.com

↑ トップへ戻る

レスポンス例

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

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

<?xml version="1.0"?>
<CreateFulfillmentOrderResponse xmlns="http://mws.amazonaws.com/FulfillmentOutboundShipment/2010-10-01/">
    <ResponseMetadata>
        <RequestId>d95be26c-16cf-4bbc-ab58-dce89fd4ac53</RequestId>
    </ResponseMetadata>
</CreateFulfillmentOrderResponse>

↑ トップへ戻る