« 【お知らせ】注文レポートのご利用停止期間について(2013年7月26日(金) 1:30 AM ～ 4:00 AM) | メイン | 【お知らせ】メンテナンスによるレポートシステムの停止について(2013年8月17日(金) 23:30 ～ 翌朝7:30頃) »

2013/07/25

お届け日時指定機能リリースに伴うAmazon MWSへの影響について

お届け日時指定機能がリリースされました

出品者様はこの機能をONにすることで、購入者様は購入時にお届け日時を指定しての注文が可能となります。また、出品者様側も

お届け日時指定内容が注文レポート等での取得が可能となります。

ここではAmazon MWSに関係する部分の変更についてご案内したいと思います。

影響を受けるAPI

注文API

  • ListOrdersオペレーション
  • ListOrdersByNextTokenオペレーション
  • GetOrderオペレーション

レポートAPI

  • 注文レポート(Xml, フラットファイル)

注文API 変更内容１

影響するオペレーション：ListOrders, ListOrdersByNextToken, GetOrderオペレーション

お届け日時指定された注文はShipmentServiceLevelCategoryにScheduledが返却されます。また、ShipServiceLevelにSchedDeliv JP Kanto8(関東エリアの配送日指定の配送設定) が返却されます。

Xml例: ListOrders(ListOrdersByNextTokenも同様) 
<?xml version="1.0"?>
<ListOrdersResponse xmlns="https://mws.amazonservices.com/Orders/2011-01-01">
  <ListOrdersResult>
    <Orders>
      <Order>
        <ShipmentServiceLevelCategory>Scheduled</ShipmentServiceLevelCategory>
        <OrderTotal>
          <Amount>9.00</Amount>
          <CurrencyCode>JPY</CurrencyCode>
        </OrderTotal>
        <ShipServiceLevel>SchedDeliv JP Kanto8</ShipServiceLevel>
        <MarketplaceId>A1VC38T7YXB528</MarketplaceId>
        <ShippingAddress>
          <Phone>036367****</Phone>
          <PostalCode>153-0064</PostalCode>
          <Name>目黒 勇一</Name>
          <CountryCode>JP</CountryCode>
          <StateOrRegion>東京都</StateOrRegion>
          <AddressLine3>目黒勇一会社</AddressLine3>
          <AddressLine2>目黒勇一住所２</AddressLine2>
          <AddressLine1>目黒勇一住所１</AddressLine1>
        </ShippingAddress>
        <SalesChannel>Amazon.co.jp</SalesChannel>
        <ShippedByAmazonTFM>false</ShippedByAmazonTFM>
        <OrderType>StandardOrder</OrderType>
        <BuyerEmail>*****[email protected]</BuyerEmail>
        <FulfillmentChannel>MFN</FulfillmentChannel>
        <OrderStatus>Unshipped</OrderStatus>
        <BuyerName>*********</BuyerName>
        <LastUpdateDate>2013-07-23T07:37:29Z</LastUpdateDate>
        <PurchaseDate>2013-07-23T07:36:03Z</PurchaseDate>
        <NumberOfItemsUnshipped>1</NumberOfItemsUnshipped>
        <NumberOfItemsShipped>0</NumberOfItemsShipped>
        <AmazonOrderId>***-8763504-1593604</AmazonOrderId>
        <PaymentMethod>Other</PaymentMethod>
      </Order>
    </Orders>
    <CreatedBefore>2013-07-23T10:00:29Z</CreatedBefore>
  </ListOrdersResult>
  <ResponseMetadata>
    <RequestId>***4f088-2931-49a1-bbf6-278e69d5f807</RequestId>
  </ResponseMetadata>
</ListOrdersResponse>
GetOrder 
<?xml version="1.0"?>
<GetOrderResponse xmlns="https://mws.amazonservices.com/Orders/2011-01-01">
  <GetOrderResult>
    <Orders>
      <Order>
        <ShipmentServiceLevelCategory>Scheduled</ShipmentServiceLevelCategory>
        <OrderTotal>
          <Amount>9.00</Amount>
          <CurrencyCode>JPY</CurrencyCode>
        </OrderTotal>
        <ShipServiceLevel>SchedDeliv JP Kanto8</ShipServiceLevel>
        <MarketplaceId>A1VC38T7YXB528</MarketplaceId>
        <ShippingAddress>
          <Phone>036367****</Phone>
          <PostalCode>153-0064</PostalCode>
          <Name>目黒 勇一</Name>
          <CountryCode>JP</CountryCode>
          <StateOrRegion>東京都</StateOrRegion>
          <AddressLine3>目黒勇一会社</AddressLine3>
          <AddressLine2>目黒勇一住所２</AddressLine2>
          <AddressLine1>目黒勇一住所１</AddressLine1>
        </ShippingAddress>
        <SalesChannel>Amazon.co.jp</SalesChannel>
        <ShippedByAmazonTFM>false</ShippedByAmazonTFM>
        <OrderType>StandardOrder</OrderType>
        <BuyerEmail>[email protected]</BuyerEmail>
        <FulfillmentChannel>MFN</FulfillmentChannel>
        <OrderStatus>Unshipped</OrderStatus>
        <BuyerName>************</BuyerName>
        <LastUpdateDate>2013-07-23T07:37:29Z</LastUpdateDate>
        <PurchaseDate>2013-07-23T07:36:03Z</PurchaseDate>
        <NumberOfItemsUnshipped>1</NumberOfItemsUnshipped>
        <NumberOfItemsShipped>0</NumberOfItemsShipped>
        <AmazonOrderId>***-8763504-1593604</AmazonOrderId>
        <PaymentMethod>Other</PaymentMethod>
      </Order>
    </Orders>
  </GetOrderResult>
  <ResponseMetadata>
    <RequestId>97d7bc6d-61a8-446e-af1f-bb5b3b38c419</RequestId>
  </ResponseMetadata>
</GetOrderResponse>

注文API 変更内容２

影響するオペレーション：ListOrderItemsオペレーション

お届け日時指定された注文は指定配送日としてScheduledDeliveryStartDate、ScheduledDeliveryEndDateが返却されます。

以下は2013年7月13日08:00～22:00 にお届け日時指定された注文の例です。

ListOrderItems 
<?xml version="1.0"?>
<ListOrderItemsResponse xmlns="https://mws.amazonservices.com/Orders/2011-01-01">
  <ListOrderItemsResult>
    <OrderItems>
      <OrderItem>
        <OrderItemId>***19030010038</OrderItemId>
        <GiftWrapPrice>
          <Amount>0.00</Amount>
          <CurrencyCode>JPY</CurrencyCode>
        </GiftWrapPrice>
        <QuantityOrdered>1</QuantityOrdered>
        <GiftWrapTax>
          <Amount>0.00</Amount>
          <CurrencyCode>JPY</CurrencyCode>
        </GiftWrapTax>
        <SellerSKU>TEST_201307111430</SellerSKU>
        <Title>Scheduled Delivery用テスト商品</Title>
        <ShippingTax>
          <Amount>0.00</Amount>
          <CurrencyCode>JPY</CurrencyCode>
        </ShippingTax>
        <ShippingPrice>
          <Amount>8.00</Amount>
          <CurrencyCode>JPY</CurrencyCode>
        </ShippingPrice>
        <ScheduledDeliveryEndDate>2013-07-31T22:00:00.000+09:00</ScheduledDeliveryEndDate>
        <ItemTax>
          <Amount>0.00</Amount>
          <CurrencyCode>JPY</CurrencyCode>
        </ItemTax>
        <ItemPrice>
          <Amount>1.00</Amount>
          <CurrencyCode>JPY</CurrencyCode>
        </ItemPrice>
        <ScheduledDeliveryStartDate>2013-07-31T08:00:00.000+09:00</ScheduledDeliveryStartDate>
        <PromotionDiscount>
          <Amount>0.00</Amount>
          <CurrencyCode>JPY</CurrencyCode>
        </PromotionDiscount>
        <ASIN>B00DVDT***</ASIN>
        <ConditionId>New</ConditionId>
        <QuantityShipped>0</QuantityShipped>
        <ConditionSubtypeId>New</ConditionSubtypeId>
        <ShippingDiscount>
          <Amount>0.00</Amount>
          <CurrencyCode>JPY</CurrencyCode>
        </ShippingDiscount>
      </OrderItem>
    </OrderItems>
    <AmazonOrderId>***-8763504-1593604</AmazonOrderId>
  </ListOrderItemsResult>
  <ResponseMetadata>
    <RequestId>8eda3753-6833-46ab-b638-3c05516acb9f</RequestId>
  </ResponseMetadata>
</ListOrderItemsResponse>

レポートAPI 変更内容

定期的な注文レポート(Xml)にて以下の変更点があります。

お届け日時指定された注文はFulfillmentServiceLevelに Scheduled が返却されます。

お届け日時指定された注文は指定配送日としてScheduledDeliveryStartDate、ScheduledDeliveryEndDateが返却されます。

定期的な注文レポート(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>M_MATS_20129965</MerchantIdentifier>
</Header>
<MessageType>OrderReport</MessageType>
<Message>
<MessageID>1</MessageID>
<OrderReport>
<AmazonOrderID>***-8763504-1593604</AmazonOrderID>
<AmazonSessionID>***-8763504-1593604</AmazonSessionID>
<OrderDate>2013-07-23T07:36:03+00:00</OrderDate>
<OrderPostedDate>2013-07-23T07:36:03+00:00</OrderPostedDate>
<BillingData>
<BuyerEmailAddress>[email protected]</BuyerEmailAddress>
<BuyerName>目黒 勇一</BuyerName>
<BuyerPhoneNumber>036367****</BuyerPhoneNumber>
<Address>
<Name>目黒 勇一</Name>
<AddressFieldOne>目黒勇一住所１</AddressFieldOne>
<AddressFieldTwo>目黒勇一住所２</AddressFieldTwo>
<AddressFieldThree>目黒勇一会社</AddressFieldThree>
<City/>
<StateOrRegion>東京都</StateOrRegion>
<PostalCode>153-0064</PostalCode>
<CountryCode>JP</CountryCode>
<PhoneNumber>036367****</PhoneNumber>
</Address>
</BillingData>
<FulfillmentData>
<FulfillmentMethod>Ship</FulfillmentMethod>
<FulfillmentServiceLevel>Scheduled</FulfillmentServiceLevel>
<Address>
<Name>目黒 勇一</Name>
<AddressFieldOne>目黒勇一住所１</AddressFieldOne>
<AddressFieldTwo>目黒勇一住所２</AddressFieldTwo>
<AddressFieldThree>目黒勇一会社</AddressFieldThree>
<City/>
<StateOrRegion>東京都</StateOrRegion>
<PostalCode>153-0064</PostalCode>
<CountryCode>JP</CountryCode>
<PhoneNumber>036367****</PhoneNumber>
</Address>
</FulfillmentData>
<Item>
<AmazonOrderItemCode>***19030010038</AmazonOrderItemCode>
<SKU>TEST_201307111430</SKU>
<Title>Scheduled Delivery用テスト商品</Title>
<CustomizationInfo>
<Type>ConditionType</Type>
<Data>new</Data>
</CustomizationInfo>
<CustomizationInfo>
<Type>Condition</Type>
<Data>new</Data>
</CustomizationInfo>
<CustomizationInfo>
<Type>SD-EndTime</Type>
<Data>1375275600</Data>
</CustomizationInfo>
<CustomizationInfo>
<Type>SD-WindowTZ</Type>
<Data>Asia/Tokyo</Data>
</CustomizationInfo>
<CustomizationInfo>
<Type>SD-StartTime</Type>
<Data>1375225200</Data>
</CustomizationInfo>
<CustomizationInfo>
<Type>CompoundTitle</Type>
<Data>Scheduled Delivery用テスト商品 [その他]</Data>
</CustomizationInfo>
<CustomizationInfo>
<Type>DateListed</Type>
<Data>2013-06-30T15:00:00+00:00</Data>
</CustomizationInfo>
<CustomizationInfo>
<Type>ListingID</Type>
<Data>0711NOJWWGG</Data>
</CustomizationInfo>
<CustomizationInfo>
<Type>MarketplaceID</Type>
<Data>A1VC38T7YXB528</Data>
</CustomizationInfo>
<CustomizationInfo>
<Type>SD-StartDate</Type>
<Data>2013-07-31T08:00:00+09:00</Data>
</CustomizationInfo>
<ScheduledDeliveryStartDate>2013-07-31T08:00:00+09:00</ScheduledDeliveryStartDate>
<CustomizationInfo>
<Type>SD-EndDate</Type>
<Data>2013-07-31T22:00:00+09:00</Data>
</CustomizationInfo>
<ScheduledDeliveryEndDate>2013-07-31T22:00:00+09:00</ScheduledDeliveryEndDate>
<Quantity>1</Quantity>
<ProductTaxCode>PTC_PRODUCT_TAXABLE_A</ProductTaxCode>
<ItemPrice>
<Component>
<Type>Principal</Type>
<Amount currency="JPY">1</Amount>
</Component>
<Component>
<Type>Shipping</Type>
<Amount currency="JPY">8</Amount>
</Component>
<Component>
<Type>Tax</Type>
<Amount currency="JPY">0</Amount>
</Component>
<Component>
<Type>ShippingTax</Type>
<Amount currency="JPY">0</Amount>
</Component>
</ItemPrice>
<ItemFees>
<Fee>
<Type>Commission</Type>
<Amount currency="JPY">-1</Amount>
</Fee>
</ItemFees>
</Item>
</OrderReport>
</Message>
</AmazonEnvelope>

注文レポート(フラットファイル)、未出荷注文レポート、定期的な注文レポート(フラットファイル)

お届け日時指定された注文はship-service-levelに Scheduled が返却されます。

お届け日時指定された注文は指定配送日としてscheduled-delivery-start-date、scheduled-delivery-end-dateが返却されます。

注文レポート上のscheduled-delivery-start-date、scheduled-delivery-end-dateは出品者がお届け日時指定機能をONに設定することで表示されるようになり、一度表示されると機能をOFFにしても消えません。システム開発の際は項目の配列が変動することを想定した開発をお願いできればと思います。

お届け日時指定の機能や、タブ区切りの注文レポートの詳細につきましては 以下のセラーセントラルのヘルプページをご参照ください。

ヘルプページリンク(セラーセントラルへのログインが必要となります)

投稿情報: 08:06 カテゴリー: レポートAPI, 注文API, 注文管理 |

| | |

Amazon Services Japan
関連リンク
Amazon MWS サイト
コミュニティフォーラム
MWSニュースレターの購読
お問い合わせ(要ログイン)

検索

カテゴリー

フィードを購読

最近の記事

アーカイブ