予約注文機能 + Amazon MWS

2015年1月15日に待望の予約注文の機能がリリースされました

予約販売機能はとは？

これまで出品いただける商品は30日以内に出荷できる商品に限定されていました。 予約注文の機能がリリースされたことにより、最大365日までの発売日の商品に対して予約注文を受け付けることが可能になりました。(おもちゃとホビーカテゴリーでは、730日以内の発売日が設定できます)

機能の詳細についてはセラーセントラルのヘルプページをご参照ください。(セラーセントラルへのログインが必要です)

今回はAmazon MWSを使用した

• 予約商品の登録方法
• 予約商品の注文情報の取得方法

についてご紹介したいと思います。

予約商品の登録方法

在庫ファイルの場合

「予約商品の発売開始日」という項目に発売開始日を設定します。

在庫ファイルをタブ区切りテキストファイルに変換し、フィードAPIセクションのSubmitFeedオペレーションを使用して送信します。 (FeedType: _POST_FLAT_FILE_LISTINGS_DATA_ )

XMLファイルの場合

商品フィードを使用して発売開始日を設定します。商品フィードのReleaseDateに設定します。

サンプルXML

<?xml version="1.0" encoding="utf-8"?>
    <AmazonEnvelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="amzn-envelope.xsd">
        <Header>
            <DocumentVersion>1.01</DocumentVersion>
            <MerchantIdentifier>ListingsContentHandler</MerchantIdentifier>
        </Header>
        <MessageType>Product</MessageType>
        <Message>
            <MessageID>1</MessageID>
            <Product>
                <SKU>TEST_20150116_1004</SKU>
                <StandardProductID>
                    <Type>EAN</Type>
                    <Value>5345638124168</Value>
                </StandardProductID>
                <ReleaseDate>2015-10-01T00:00:00+09:00</ReleaseDate>
                <Condition>
                    <ConditionType>New</ConditionType>
                    <ConditionNote>新品</ConditionNote>
                </Condition>
                <DescriptionData>
                    <Title>テスト商品 TEST_20150116_1004</Title>
                    <Brand>テストブランド</Brand>
                    <Description>テスト商品説明</Description>
                    <MSRP currency="JPY">5800</MSRP>
                    <Manufacturer>テストメーカー</Manufacturer>
                    <SearchTerms>検索キーワード</SearchTerms>
                    <RecommendedBrowseNode>15319981</RecommendedBrowseNode>
                </DescriptionData>
                <ProductData>
                    <Sports>
                        <ProductType>SportingGoods</ProductType>
                        <ColorMap>ブラック</ColorMap>
                    </Sports>
                </ProductData>
            </Product>
        </Message>
    </AmazonEnvelope>

・予約商品の注文情報の取得方法

Amazon MWSでは予約注文の注文情報を注文APIを利用して取得することができます。

対象オペレーション

• ListOrders
• ListOrdersByNextToken
• GetOrder

予約注文を識別する方法

• OrderStatusがPendingAvailability
• OrderTypeがPreorder

Note

• 注文確定する直前にはOrderStatusが一時Pendingに変動します
• 注文確定するとOrderStatusがUnshippedに変動します

注文APIの仕様上OrderTypeの条件をリクエストパラメータに含めることができないため OrderStatus=PendingAvailability, Pending, Unshippedで注文情報を取得し、自社システム側でフィルタを実施くださいますようお願いいたします。

ListOrdersのレスポンスサンプル

<?xml version="1.0"?>
<ListOrdersResponse xmlns="https://mws.amazonservices.com/Orders/2013-09-01">
  <ListOrdersResult>
    <Orders>
      <Order>
        <ShipmentServiceLevelCategory>Standard</ShipmentServiceLevelCategory>
        <ShipServiceLevel>Std JP Kanto8</ShipServiceLevel>
        <LatestShipDate>2015-11-02T14:59:59Z</LatestShipDate>
        <MarketplaceId>A1VC38T7YXB528</MarketplaceId>
        <SalesChannel>Amazon.co.jp</SalesChannel>
        <EarliestDeliveryDate>2015-11-04T15:00:00Z</EarliestDeliveryDate>
        <OrderType>Preorder</OrderType>
        <BuyerEmail>[email protected]</BuyerEmail>
        <FulfillmentChannel>MFN</FulfillmentChannel>
        <LatestDeliveryDate>2015-11-08T14:59:59Z</LatestDeliveryDate>
        <OrderStatus>PendingAvailability</OrderStatus>
        <BuyerName>test buyer</BuyerName>
        <LastUpdateDate>2015-01-16T02:40:16Z</LastUpdateDate>
        <EarliestShipDate>2015-11-01T15:00:00Z</EarliestShipDate>
        <PurchaseDate>2015-01-16T02:40:02Z</PurchaseDate>
        <NumberOfItemsUnshipped>1</NumberOfItemsUnshipped>
        <NumberOfItemsShipped>0</NumberOfItemsShipped>
        <AmazonOrderId>250-2841486-9999999</AmazonOrderId>
      </Order>
    </Orders>
    <CreatedBefore>2015-01-16T02:40:21Z</CreatedBefore>
  </ListOrdersResult>
  <ResponseMetadata>
    <RequestId>cafd0760-48be-406a-966f-4d27b9999999</RequestId>
  </ResponseMetadata>
</ListOrdersResponse>

GetOrderのレスポンスサンプル

<?xml version="1.0"?>
<GetOrderResponse xmlns="https://mws.amazonservices.com/Orders/2013-09-01">
  <GetOrderResult>
    <Orders>
      <Order>
        <ShipmentServiceLevelCategory>Standard</ShipmentServiceLevelCategory>
        <ShipServiceLevel>Std JP Kanto8</ShipServiceLevel>
        <LatestShipDate>2015-11-02T14:59:59Z</LatestShipDate>
        <MarketplaceId>A1VC38T7YXB528</MarketplaceId>
        <SalesChannel>Amazon.co.jp</SalesChannel>
        <EarliestDeliveryDate>2015-11-04T15:00:00Z</EarliestDeliveryDate>
        <OrderType>Preorder</OrderType>
        <BuyerEmail>[email protected]</BuyerEmail>
        <FulfillmentChannel>MFN</FulfillmentChannel>
        <LatestDeliveryDate>2015-11-08T14:59:59Z</LatestDeliveryDate>
        <OrderStatus>PendingAvailability</OrderStatus>
        <BuyerName>test buyer</BuyerName>
        <LastUpdateDate>2015-01-16T02:40:16Z</LastUpdateDate>
        <EarliestShipDate>2015-11-01T15:00:00Z</EarliestShipDate>
        <PurchaseDate>2015-01-16T02:40:02Z</PurchaseDate>
        <NumberOfItemsUnshipped>1</NumberOfItemsUnshipped>
        <NumberOfItemsShipped>0</NumberOfItemsShipped>
        <AmazonOrderId>250-2841486-9999999</AmazonOrderId>
      </Order>
    </Orders>
  </GetOrderResult>
  <ResponseMetadata>
    <RequestId>49273031-ab02-4b40-88eb-ff1a29999999</RequestId>
  </ResponseMetadata>
</GetOrderResponse>

配送先住所(ShippingAddress)については注文確定(OrderStatus=Unshipped)後に返却されます。それまではBuyerNameとBuyerEmailのみが返却されます。

是非予約注文機能のご対応にAmazon MWSをご活用ください!