Amazonポイント利用可能となったことにより注文APIのレスポンスや注文レポートの内容が変わりました

Amazonポイント利用により注文APIのレスポンスや注文レポートの内容が変わりました

Amazonポイントは従来Amazon.co.jpでのみ利用可能でしたが、Amazonマーケットプレイスの出品者が販売する商品のご注文でも使用できるようになりました。

これに伴い、以下の条件に該当する注文が入った際、注文APIと注文レポートの内容が以下のとおり変更されます。

対象注文

支払方法が代金引換の注文（その他の支払方法は支払内訳を返却しないため影響はございません）

変更内容

・注文API - GetOrder, ListOrder, ListOrderByNextTokenオペレーションの支払内訳にAmazonポイント分の内訳として新しいPaymentMethodのPointsAccountが返却されます。

・注文レポート - Amazonポイントで支払った分が事前支払額(already-paid)の項目に計上されます。Amazonギフト券でも支払が行われている場合、ギフト券額との合算値が返却されます。

注文APIのレスポンス内容の変更点

GetOrder

ポイント支払分が以下レスポンスがPaymentMethod=PointsAccountとして返却されます

<?xml version="1.0"?>
<GetOrderResponse xmlns="https://mws.amazonservices.com/Orders/2013-09-01">
  <GetOrderResult>
    <Orders>
      <Order>
        <ShipmentServiceLevelCategory>Standard</ShipmentServiceLevelCategory>
        <OrderTotal>
          <Amount>1507.00</Amount>
          <CurrencyCode>JPY</CurrencyCode>
        </OrderTotal>
        <ShipServiceLevel>Std JP Kanto8</ShipServiceLevel>
        <LatestShipDate>2014-05-08T14:59:59Z</LatestShipDate>
        <MarketplaceId>A1VC38T7YXB528</MarketplaceId>
        <SalesChannel>Amazon.co.jp</SalesChannel>
        <ShippingAddress>
          <Phone>03-6367-9999</Phone>
          <PostalCode>153-9999</PostalCode>
          <Name>テスト 受取人</Name>
          <CountryCode>JP</CountryCode>
          <StateOrRegion>Tokyo-to</StateOrRegion>
          <AddressLine2>江戸タワーANNEX20F</AddressLine2>
          <AddressLine1>目黒区下目黒9-99-9</AddressLine1>
        </ShippingAddress>
        <EarliestDeliveryDate>2014-05-08T15:00:00Z</EarliestDeliveryDate>
        <ShippedByAmazonTFM>false</ShippedByAmazonTFM>
        <OrderType>StandardOrder</OrderType>
        <FulfillmentChannel>MFN</FulfillmentChannel>
        <BuyerEmail>[email protected]</BuyerEmail>
        <LatestDeliveryDate>2014-05-13T14:59:59Z</LatestDeliveryDate>
        <PaymentExecutionDetail>
          <PaymentExecutionDetailItem>
            <Payment>
              <Amount>10.00</Amount>
              <CurrencyCode>JPY</CurrencyCode>
            </Payment>
            <PaymentMethod>PointsAccount</PaymentMethod>
          </PaymentExecutionDetailItem>
          <PaymentExecutionDetailItem>
            <Payment>
              <Amount>1497.00</Amount>
              <CurrencyCode>JPY</CurrencyCode>
            </Payment>
            <PaymentMethod>COD</PaymentMethod>
          </PaymentExecutionDetailItem>
        </PaymentExecutionDetail>
        <OrderStatus>Unshipped</OrderStatus>
        <BuyerName>テスト　バイヤー</BuyerName>
        <LastUpdateDate>2014-05-01T10:27:45Z</LastUpdateDate>
        <EarliestShipDate>2014-05-06T15:00:00Z</EarliestShipDate>
        <PurchaseDate>2014-05-01T10:22:02Z</PurchaseDate>
        <NumberOfItemsUnshipped>1</NumberOfItemsUnshipped>
        <AmazonOrderId>249-7054228-9999999</AmazonOrderId>
        <NumberOfItemsShipped>0</NumberOfItemsShipped>
        <PaymentMethod>COD</PaymentMethod>
      </Order>
    </Orders>
  </GetOrderResult>
  <ResponseMetadata>
    <RequestId>382bebbd-0035-460b-abd8-a64f15999999</RequestId>
  </ResponseMetadata>
</GetOrderResponse>

ListOrders, ListOrdersByNextToken

ポイント支払分が以下レスポンスがPaymentMethod=PointsAccountとして返却されます

<?xml version="1.0"?>
<ListOrdersResponse xmlns="https://mws.amazonservices.com/Orders/2013-09-01">
  <ListOrdersResult>
    <Orders>
      <Order>
        <ShipmentServiceLevelCategory>Standard</ShipmentServiceLevelCategory>
        <OrderTotal>
          <Amount>1507.00</Amount>
          <CurrencyCode>JPY</CurrencyCode>
        </OrderTotal>
        <ShipServiceLevel>Std JP Kanto8</ShipServiceLevel>
        <LatestShipDate>2014-05-08T14:59:59Z</LatestShipDate>
        <MarketplaceId>A1VC38T7YXB528</MarketplaceId>
        <ShippingAddress>
          <Phone>03-6367-9999</Phone>
          <PostalCode>153-9999</PostalCode>
          <Name>テスト 受取人</Name>
          <CountryCode>JP</CountryCode>
          <StateOrRegion>Tokyo-to</StateOrRegion>
          <AddressLine2>江戸タワーANNEX20F</AddressLine2>
          <AddressLine1>目黒区下目黒9-99-9</AddressLine1>
        </ShippingAddress>
        <SalesChannel>Amazon.co.jp</SalesChannel>
        <EarliestDeliveryDate>2014-05-08T15:00:00Z</EarliestDeliveryDate>
        <ShippedByAmazonTFM>false</ShippedByAmazonTFM>
        <OrderType>StandardOrder</OrderType>
        <FulfillmentChannel>MFN</FulfillmentChannel>
        <BuyerEmail>[email protected]</BuyerEmail>
        <LatestDeliveryDate>2014-05-13T14:59:59Z</LatestDeliveryDate>
        <PaymentExecutionDetail>
          <PaymentExecutionDetailItem>
            <Payment>
              <Amount>10.00</Amount>
              <CurrencyCode>JPY</CurrencyCode>
            </Payment>
            <PaymentMethod>PointsAccount</PaymentMethod>
          </PaymentExecutionDetailItem>
          <PaymentExecutionDetailItem>
            <Payment>
              <Amount>1497.00</Amount>
              <CurrencyCode>JPY</CurrencyCode>
            </Payment>
            <PaymentMethod>COD</PaymentMethod>
          </PaymentExecutionDetailItem>
        </PaymentExecutionDetail>
        <OrderStatus>Unshipped</OrderStatus>
        <BuyerName>テスト　バイヤー</BuyerName>
        <LastUpdateDate>2014-05-01T10:27:45Z</LastUpdateDate>
        <EarliestShipDate>2014-05-06T15:00:00Z</EarliestShipDate>
        <PurchaseDate>2014-05-01T10:22:02Z</PurchaseDate>
        <NumberOfItemsUnshipped>1</NumberOfItemsUnshipped>
        <NumberOfItemsShipped>0</NumberOfItemsShipped>
        <PaymentMethod>COD</PaymentMethod>
        <AmazonOrderId>249-7054228-9999999</AmazonOrderId>
      </Order>
    </Orders>
    <CreatedBefore>2014-05-14T15:00:00Z</CreatedBefore>
  </ListOrdersResult>
  <ResponseMetadata>
    <RequestId>6e8a93e0-80d0-41a3-aeae-583d0f999999</RequestId>
  </ResponseMetadata>
</ListOrdersResponse>

注文レポートの変更点

already-paidの項目にAmazonポイント使用分の金額が計上されます(右スクロールを避けるため、1行のレポートを折り返して表示いたしております)