« 予約注文機能 + Amazon MWS | メイン | MWSAuthTokenパラメータの必須化までもうすぐです! »

2015/02/20

Amazon ポイントプログラムの機能が公開されました

【2019.07.04 追記】

2019年7月31日に、ファイルアップロードおよびフィードAPIを利用した価格更新時のAmazonポイントの挙動の変更が予定されています。詳しくは下記の記事をご参照ください。

ファイルアップロードおよびフィードAPIを利用した価格更新時のAmazonポイントの挙動の変更について

Amazon出品サービスに新たな機能、 Amazonポイントプログラムが公開されました！

これまでAmazonポイントプログラムは段階的に機能が公開されており、

まず、2014年・・・購入者様が出品者様が出品している商品の注文時にポイントの利用が可能になりました。（ポイント利用）

そして今回の機能の公開では、

出品者様が出品している商品を購入した購入者様にポイントを付与することが可能になりました。

Amazonポイントの機能全般についてはセラーセントラルのヘルプページをご参照ください（セラーセントラルへのログインが必要です）

今回は本機能追加により発生するAmazon MWSをご利用の皆様に影響する変更内容をご紹介いたします。

商品登録(関連：フィードAPI)

以下のファイルにAmazonポイントを設定するための項目(ポイント、セール価格適用時ポイント)が追加されました。

ファイル追加項目
カテゴリー在庫ファイル
（DVD&ビデオ、ミュージック・エレクトロニクス・Kindle アクセサリ以外）		 standard_price（ポイント）
sales_price_points（セール時のポイント）
カテゴリー別在庫ファイル（DVD&ビデオ）
カテゴリー別在庫ファイル（ミュージック）		 standard_price_points（ポイント）
カテゴリー別在庫ファイル（エレクトロニクス）
カテゴリー別在庫ファイル（Kindle アクセサリ）		 standard-price-points（ポイント）
sales-price-points（セール時のポイント）
出品ファイル(L) standard-price-points（ポイント）
sales-price-points（セール時のポイント）
出品ファイル(I) standard-price-points（ポイント）
価格と数量変更ファイル（汎用版） standard-price-points（ポイント）
sales-price-points（セール時のポイント）
価格と数量変更ファイル（本・ミュージック・ビデオ・DVD） standard-price-points（ポイント）

注：価格とポイントの項目は同時に更新する必要があります。価格のみ更新すると設定済みのポイント数はクリアされます。

レポート(関連：レポートAPI)

以下のレポートにAmazonポイントに関連する項目が出力されます

☆・・・ポイントの項目の出力有無を出品者ご自身で選択いただけます。出力有無を設定頂くためには出品者様よりセラーセントラルから設定頂く必要があります。

レポート名ReportType出力有無設定要否追加項目
出品詳細レポート _GET_MERCHANT_LISTINGS_DATA_ ☆ standard-price-point
出品中の商品レポート _GET_MERCHANT_LISTINGS_DATA_BACK_COMPAT_ ☆ standard-price-point
キャンセルされた商品レポート _GET_MERCHANT_CANCELLED_LISTINGS_DATA_ ☆ standard-price-point
新しい注文レポート _GET_FLAT_FILE_ORDERS_DATA_ ☆ points-granted
未出荷の注文レポート _GET_FLAT_FILE_ACTIONABLE_ORDER_DATA_ ☆ points-granted
注文レポート(XML) _GET_ORDER_REPORT_DATA_ ☆ points_granted
決済レポート _GET_V2_SETTLEMENT_REPORT_DATA_FLAT_FILE_ PointsGranted
PointsReturned
(item-related-fee-typeの値として)
決済レポートV2 _GET_V2_SETTLEMENT_REPORT_DATA_FLAT_FILE_V2_ Points(amount-typeの値として)
PointsGranted(amount-descriptionの値として)
PointsReturned(amount-descriptionの値として)
XMLの決済レポート _GET_V2_SETTLEMENT_REPORT_DATA_XML_ CostOfPointsGranted
CostOfPointsReturned
全注文レポート(最終更新日/フラットファイル) _GET_FLAT_FILE_ALL_ORDERS_DATA_BY_LAST_UPDATE_ ☆ points-granted
全注文レポート(発注日/フラットファイル) _GET_FLAT_FILE_ALL_ORDERS_DATA_BY_ORDER_DATE_ ☆ points-granted
全注文レポート(最終更新日/ XML) _GET_XML_ALL_ORDERS_DATA_BY_LAST_UPDATE_ ☆ points-granted
全注文レポート(発注日/ XML) _GET_XML_ALL_ORDERS_DATA_BY_ORDER_DATE_ ☆ points-granted
出荷レポート _GET_AMAZON_FULFILLED_SHIPMENTS_DATA_ "付与されたAmazon ポイント"
FBA在庫出荷レポート _GET_AFN_INVENTORY_DATA_ "付与されたAmazon ポイント"

注文API

ListOrderItems 及び ListOrderItemsByNextToken オペレーションが任意でPointsGranted要素を返します。PointsGranted要素には注文時に付与したAmazonポイントの数値と金額 が含まれます。対象マーケットプレイスはJPのみです。

[ListOrderItems] 
<?xml version="1.0"?>
<ListOrderItemsResponse xmlns="https://mws.amazonservices.com/Orders/2013-09-01">
  <ListOrderItemsResult>
    <OrderItems>
      <OrderItem>
        <OrderItemId>53538341659999</OrderItemId>
        <QuantityOrdered>1</QuantityOrdered>
        <PointsGranted>
          <PointsMonetaryValue>
            <Amount>10.00</Amount>
            <CurrencyCode>JPY</CurrencyCode>
          </PointsMonetaryValue>
          <PointsNumber>10</PointsNumber>
        </PointsGranted>
        <SellerSKU>20140730_0764588338</SellerSKU>
        <Title>Professional CSS: Cascading Style Sheets for Web Design [ペーパーバック] [2005] Schmitt, Christopher; Trammell, Mark; Marcotte, Ethan; Orchard, Dunstan; Dominey, Todd</Title>
        <ShippingTax>
          <Amount>0.00</Amount>
          <CurrencyCode>JPY</CurrencyCode>
        </ShippingTax>
        <ShippingPrice>
          <Amount>360.00</Amount>
          <CurrencyCode>JPY</CurrencyCode>
        </ShippingPrice>
        <ItemTax>
          <Amount>0.00</Amount>
          <CurrencyCode>JPY</CurrencyCode>
        </ItemTax>
        <ItemPrice>
          <Amount>99.00</Amount>
          <CurrencyCode>JPY</CurrencyCode>
        </ItemPrice>
        <PromotionDiscount>
          <Amount>0.00</Amount>
          <CurrencyCode>JPY</CurrencyCode>
        </PromotionDiscount>
        <ASIN>0764588338</ASIN>
        <QuantityShipped>1</QuantityShipped>
        <ShippingDiscount>
          <Amount>0.00</Amount>
          <CurrencyCode>JPY</CurrencyCode>
        </ShippingDiscount>
      </OrderItem>
    </OrderItems>
    <AmazonOrderId>249-0324699-6209999</AmazonOrderId>
  </ListOrderItemsResult>
  <ResponseMetadata>
    <RequestId>022de856-a296-4948-b85f-06ec96469999</RequestId>
  </ResponseMetadata>
</ListOrderItemsResponse>

商品API

GetCompetitivePricingForSKU、GetCompetitivePricingForASIN、 GetLowestOfferListingsForSKU、GetLowestOfferListingsForASIN、GetMyPriceForSKU及びGetMyPriceForASINオペレーションがPrice要素の一部として任意でPoints子要素を返します。Points要素には出品に対して設定したAmazonポイント数とその金額が含まれます。対象マーケットプレイスはJPのみです。

[GetCompetitivePricingForASIN]

<?xml version="1.0"?>
<GetCompetitivePricingForASINResponse xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01">
<GetCompetitivePricingForASINResult ASIN="B0020RZLZU" status="Success">
  <Product xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01" xmlns:ns2="http://mws.amazonservices.com/schema/Products/2011-10-01/default.xsd">
    <Identifiers>
      <MarketplaceASIN>
        <MarketplaceId>A1VC38T7YXB528</MarketplaceId>
        <ASIN>B0020RZLZU</ASIN>
      </MarketplaceASIN>
    </Identifiers>
    <CompetitivePricing>
      <CompetitivePrices>
        <CompetitivePrice belongsToRequester="false" condition="New" subcondition="New">
          <CompetitivePriceId>1</CompetitivePriceId>
          <Price>
            <LandedPrice>
              <CurrencyCode>JPY</CurrencyCode>
              <Amount>3220.00</Amount>
            </LandedPrice>
            <ListingPrice>
              <CurrencyCode>JPY</CurrencyCode>
              <Amount>3220.00</Amount>
            </ListingPrice>
            <Shipping>
              <CurrencyCode>JPY</CurrencyCode>
              <Amount>0.00</Amount>
            </Shipping>
            <Points>
              <PointsNumber>322</PointsNumber>
              <PointsMonetaryValue>
                <CurrencyCode>JPY</CurrencyCode>
                <Amount>322.00</Amount>
              </PointsMonetaryValue>
            </Points>
          </Price>
        </CompetitivePrice>
      </CompetitivePrices>
      <NumberOfOfferListings>
        <OfferListingCount condition="Any">24</OfferListingCount>
        <OfferListingCount condition="New">24</OfferListingCount>
      </NumberOfOfferListings>
    </CompetitivePricing>
    <SalesRankings>
      <SalesRank>
        <ProductCategoryId>musical_instruments_display_on_website</ProductCategoryId>
        <Rank>88</Rank>
      </SalesRank>
      <SalesRank>
        <ProductCategoryId>2129858051</ProductCategoryId>
        <Rank>3</Rank>
      </SalesRank>
    </SalesRankings>
  </Product>
</GetCompetitivePricingForASINResult>
<ResponseMetadata>
  <RequestId>8555e9bd-c583-47fc-8b88-672e6eb29999</RequestId>
</ResponseMetadata>
</GetCompetitivePricingForASINResponse>

[GetLowestOfferListingsForASIN]

<?xml version="1.0"?>
<GetLowestOfferListingsForASINResponse xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01">
<GetLowestOfferListingsForASINResult ASIN="0764588338" status="Success">
  <AllOfferListingsConsidered>true</AllOfferListingsConsidered>
  <Product xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01" xmlns:ns2="http://mws.amazonservices.com/schema/Products/2011-10-01/default.xsd">
    <Identifiers>
      <MarketplaceASIN>
        <MarketplaceId>A1VC38T7YXB528</MarketplaceId>
        <ASIN>0764588338</ASIN>
      </MarketplaceASIN>
    </Identifiers>
    <LowestOfferListings>
      <LowestOfferListing>
        <Qualifiers>
          <ItemCondition>Used</ItemCondition>
          <ItemSubcondition>Acceptable</ItemSubcondition>
          <FulfillmentChannel>Amazon</FulfillmentChannel>
          <ShipsDomestically>True</ShipsDomestically>
          <ShippingTime>
            <Max>0-2 days</Max>
          </ShippingTime>
          <SellerPositiveFeedbackRating>Just Launched</SellerPositiveFeedbackRating>
        </Qualifiers>
        <NumberOfOfferListingsConsidered>1</NumberOfOfferListingsConsidered>
        <SellerFeedbackCount>0</SellerFeedbackCount>
       <Price>
          <LandedPrice>
            <CurrencyCode>JPY</CurrencyCode>
            <Amount>99.00</Amount>
          </LandedPrice>
          <ListingPrice>
            <CurrencyCode>JPY</CurrencyCode>
            <Amount>99.00</Amount>
          </ListingPrice>
          <Shipping>
            <CurrencyCode>JPY</CurrencyCode>
            <Amount>0.00</Amount>
          </Shipping>
          <Points>
            <PointsNumber>10</PointsNumber>
            <PointsMonetaryValue>
              <CurrencyCode>JPY</CurrencyCode>
              <Amount>10.00</Amount>
            </PointsMonetaryValue>
          </Points>
        </Price>
        <MultipleOffersAtLowestPrice>False</MultipleOffersAtLowestPrice>
      </LowestOfferListing>
      
      (LowestOfferListing要素 一部省略)
      
    </LowestOfferListings>
  </Product>
</GetLowestOfferListingsForASINResult>
<ResponseMetadata>
  <RequestId>2bb50af6-c79c-48b2-a766-99e5f1969999</RequestId>
</ResponseMetadata>
</GetLowestOfferListingsForASINResponse>

[GetMyPriceForASIN]

<?xml version="1.0"?>
<GetMyPriceForASINResponse xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01">
<GetMyPriceForASINResult ASIN="B009V58142" status="Success">
  <Product xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01" xmlns:ns2="http://mws.amazonservices.com/schema/Products/2011-10-01/default.xsd">
    <Identifiers>
      <MarketplaceASIN>
        <MarketplaceId>A1VC38T7YXB528</MarketplaceId>
        <ASIN>B009V58142</ASIN>
      </MarketplaceASIN>
    </Identifiers>
    <Offers>
      <Offer>
        <BuyingPrice>
          <LandedPrice>
            <CurrencyCode>JPY</CurrencyCode>
            <Amount>5010.00</Amount>
          </LandedPrice>
          <ListingPrice>
            <CurrencyCode>JPY</CurrencyCode>
            <Amount>5000.00</Amount>
          </ListingPrice>
          <Shipping>
            <CurrencyCode>JPY</CurrencyCode>
            <Amount>10.00</Amount>
          </Shipping>
          <Points>
            <PointsNumber>500</PointsNumber>
            <PointsMonetaryValue>
              <CurrencyCode>JPY</CurrencyCode>
              <Amount>500.00</Amount>
            </PointsMonetaryValue>
          </Points>
        </BuyingPrice>
        <RegularPrice>
          <CurrencyCode>JPY</CurrencyCode>
          <Amount>5000.00</Amount>
        </RegularPrice>
        <FulfillmentChannel>MERCHANT</FulfillmentChannel>
        <ItemCondition>New</ItemCondition>
        <ItemSubCondition>New</ItemSubCondition>
        <SellerId>A3JLPMZ4L29999</SellerId>
        <SellerSKU>TEST_20140523_1401</SellerSKU>
      </Offer>
    </Offers>
  </Product>
</GetMyPriceForASINResult>
<ResponseMetadata>
  <RequestId>129c0e5e-eaf8-4457-ab99-553baca59999</RequestId>
</ResponseMetadata>
</GetMyPriceForASINResponse>

サブスクリプションAPI

AnyOfferChangedNotificationオペレーションの複合要素にPoints要素が追加され、PointsNumberが子要素として追加されます。複合要素BuyBoxPrice、LowestPrice、OfferにPointsの子要素が追加されます。対象マーケットプレイスはJPのみです。

<Notification>
<NotificationMetaData>
	<NotificationType>AnyOfferChanged</NotificationType>
	<PayloadVersion>1.0</PayloadVersion>
	<UniqueId>72f001f8-cc55-44b5-9b84-5d1fe37d9999</UniqueId>
	<PublishTime>2015-02-18T22:53:24.587Z</PublishTime>
	<SellerId>A3JLPMZ4L29999</SellerId>
	<MarketplaceId>A1VC38T7YXB528</MarketplaceId>
</NotificationMetaData>
<NotificationPayload>
	<AnyOfferChangedNotification>
		<OfferChangeTrigger>
			<MarketplaceId>A1VC38T7YXB528</MarketplaceId>
			<ASIN>B009V58142</ASIN>
			<ItemCondition>new</ItemCondition>
			<TimeOfOfferChange>2015-02-18T22:53:24.130Z</TimeOfOfferChange>
		</OfferChangeTrigger>
		<Summary>
			<NumberOfOffers>
				<OfferCount condition="new" fulfillmentChannel="Amazon">1</OfferCount>
				<OfferCount condition="new" fulfillmentChannel="Merchant">6</OfferCount>
			</NumberOfOffers>
			<LowestPrices>
				<LowestPrice condition="new" fulfillmentChannel="Amazon">
					<LandedPrice>
						<Amount>1445</Amount>
						<CurrencyCode>JPY</CurrencyCode>
					</LandedPrice>
					<ListingPrice>
						<Amount>1445</Amount>
						<CurrencyCode>JPY</CurrencyCode>
					</ListingPrice>
					<Shipping>
						<Amount>0</Amount>
						<CurrencyCode>JPY</CurrencyCode>
					</Shipping>
				</LowestPrice>
				<LowestPrice condition="new" fulfillmentChannel="Merchant">
					<LandedPrice>
						<Amount>2050</Amount>
						<CurrencyCode>JPY</CurrencyCode>
					</LandedPrice>
					<ListingPrice>
						<Amount>1580</Amount>
						<CurrencyCode>JPY</CurrencyCode>
					</ListingPrice>
					<Shipping>
						<Amount>470</Amount>
						<CurrencyCode>JPY</CurrencyCode>
					</Shipping>
				</LowestPrice>
			</LowestPrices>
			<BuyBoxPrices>
				<BuyBoxPrice condition="new">
					<LandedPrice>
						<Amount>2155</Amount>
						<CurrencyCode>JPY</CurrencyCode>
					</LandedPrice>
					<ListingPrice>
						<Amount>1815</Amount>
						<CurrencyCode>JPY</CurrencyCode>
					</ListingPrice>
					<Shipping>
						<Amount>340</Amount>
						<CurrencyCode>JPY</CurrencyCode>
					</Shipping>
				</BuyBoxPrice>
			</BuyBoxPrices>
			<ListPrice>
				<Amount>1600</Amount>
				<CurrencyCode>JPY</CurrencyCode>
			</ListPrice>
			<SuggestedLowerPricePlusShipping>
				<Amount>1431</Amount>
				<CurrencyCode>JPY</CurrencyCode>
			</SuggestedLowerPricePlusShipping>
			
			<SalesRankings>
				<SalesRank>
					<ProductCategoryId>ce_display_on_website</ProductCategoryId>
					<Rank>5327</Rank>
				</SalesRank>
				<SalesRank>
					<ProductCategoryId>2285175051</ProductCategoryId>
					<Rank>2</Rank>
				</SalesRank>
				<SalesRank>
					<ProductCategoryId>3477431</ProductCategoryId>
					<Rank>828</Rank>
				</SalesRank>
			</SalesRankings>
			
			<BuyBoxEligibleOffers>
				<OfferCount condition="new" fulfillmentChannel="Amazon">1</OfferCount>
				<OfferCount condition="new" fulfillmentChannel="Merchant">6</OfferCount>
			</BuyBoxEligibleOffers>
		</Summary>
		<Offers>
			
			（Offer要素 一部省略）
			
			<Offer>
				<SellerId>A3JLPMZ4L29999</SellerId>
				<SubCondition>new</SubCondition>
				<SellerFeedbackRating>
					<FeedbackCount>0</FeedbackCount>
				</SellerFeedbackRating>
				<ShippingTime minimumHours="24" maximumHours="48" availabilityType="NOW"/>
				<ListingPrice>
					<Amount>5000</Amount>
					<CurrencyCode>JPY</CurrencyCode>
				</ListingPrice>
				<Points><PointsNumber>500</PointsNumber></Points>
				<Shipping>
					<Amount>10</Amount>
					<CurrencyCode>JPY</CurrencyCode>
				</Shipping>
				<ShipsFrom>
					<Country>JP</Country>
					<State></State>
				</ShipsFrom>
				<IsFulfilledByAmazon>false</IsFulfilledByAmazon>
				<IsBuyBoxWinner>false</IsBuyBoxWinner>
				<ConditionNotes>新品</ConditionNotes>
				<IsExpeditedShippingAvailable>false</IsExpeditedShippingAvailable>
				<IsFeaturedMerchant>true</IsFeaturedMerchant>
				<ShipsDomestically>true</ShipsDomestically>
				<ShipsInternationally>false</ShipsInternationally>
			</Offer>
		</Offers>
    </AnyOfferChangedNotification>
</NotificationPayload>
</Notification>

皆様の開発時の参考となれば幸いです。是非Amazonポイント機能、 Amazon MWSをご利用ください!

投稿情報: 10:04 カテゴリー: Amazonポイント, 出品管理, 注文管理 |

| | |

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

検索

カテゴリー

フィードを購読

最近の記事

アーカイブ