Amazon マーケットプレイスWebサービス(MWS) 日本公式ブログ: Amazonポイント

Amazonポイント

2019/07/04

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

【2019.07.30 追記】

2019年7月31日に適用予定となっていた本変更ですが、適用時期が延期となりました。最新情報は下記セラーフォーラム記事をご確認ください。

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

2019年7月31日より、セラーセントラルからのファイル（カテゴリー別在庫ファイル、出品ファイル(L)(I)、価格と数量変更ファイル、カスタムテンプレート）のアップロードおよびフィードAPIを使用した価格更新において、既に設定されているAmazonポイントの付与数に対する挙動が変更されます。

■変更内容

付与するAmazonポイントが設定されている商品の価格更新時に、ポイント設定項目にブランクを指定またはポイント設定項目自体を含めない場合の挙動が下記のように変更されます。

変更前	変更後
付与されるポイント数を0に上書き。	設定済みの付与ポイント数を維持。

■影響

上記の仕様変更により、フィードAPIによる価格更新時に下記のパターンで付与ポイントの削除を行っている開発者様は対応が必要となります。

パターン	必要な対応
ポイントを削除する際に、ポイント設定項目をブランクにして更新している。	ポイントを削除する際には、ポイント設定項目にブランクではなく0を設定する。
ポイントを削除する際に、ポイント設定項目をフィードに含めずに更新している。	ポイントを削除する際には、ポイント設定項目をフィードに含め、かつ、値に0を設定する。

なお、上記仕様変更の影響を受ける各種ファイル・フィードにおいて、商品の販売価格、セール価格およびそれぞれの価格に対応するポイント数の設定項目名は下記となります。

ファイル/フィード	フィードタイプ	価格設定項目	ポイント設定項目
カスタム在庫ファイル, カテゴリー別在庫ファイル	_POST_FLAT_FILE_LISTINGS_DATA_	standard_price	standard_price_points
カスタム在庫ファイル, カテゴリー別在庫ファイル	_POST_FLAT_FILE_LISTINGS_DATA_	sale_price	sale_price_points
出品ファイル(L)	_POST_FLAT_FILE_LISTINGS_DATA_	price	standard-price-points
出品ファイル(L)	_POST_FLAT_FILE_LISTINGS_DATA_	sale-price	sale-price-points
出品ファイル(I)	_POST_FLAT_FILE_INVLOADER_DATA_	price	standard-price-points
価格と数量変更ファイル(フラットファイル価格と数量更新フィード)	_POST_FLAT_FILE_PRICEANDQUANTITYONLY_UPDATE_DATA_	price	standard-price-points
価格と数量変更ファイル(フラットファイル価格と数量更新フィード)	_POST_FLAT_FILE_PRICEANDQUANTITYONLY_UPDATE_DATA_	sale-price	sale-price-points
フラットファイル本の商品登録フィード	_POST_FLAT_FILE_BOOKLOADER_DATA_	standard_price	standard_price_points
フラットファイル本の商品登録フィード	_POST_FLAT_FILE_BOOKLOADER_DATA_	sale_price	sale_price_points
フラットファイルミュージックの商品登録フィード	_POST_FLAT_FILE_CONVERGENCE_LISTINGS_DATA_	standard_price	standard_price_points
フラットファイルミュージックの商品登録フィード	_POST_FLAT_FILE_CONVERGENCE_LISTINGS_DATA_	sale_price	sale_price_points
価格フィード	_POST_PRODUCT_PRICING_DATA_	StandardPrice	StandardPricePoints
価格フィード	_POST_PRODUCT_PRICING_DATA_	SalePrice	SalePricePoints

以上、開発の参考にしていただけますと幸いです。

投稿情報: 16:51 カテゴリー: Amazonポイント | 個別ページ

2017/02/28

XMLの注文レポートにAmazonポイント数を表示させる方法について

今回はXML形式の注文レポートに、購入者様に付与されたAmazonポイント数を表示させる方法についてご紹介します。

2015年2月より、出品者様が出品している商品を購入した購入者様にポイントを付与することが可能になり、これに伴い注文レポートおよび注文APIにpoints-grantedというカラムが追加され購入者に付与されたAmazonポイント数が確認できるようになっています。

詳細はAmazon ポイントプログラムの機能をご確認ください。

points-grantedは、初期設定では注文レポートおよび注文APIにカラム追加されておらず、カラムの追加設定方法はXML形式の注文レポートとそれ以外とでは手順が異なりますのでご注意ください。

レポート名	ReportType	追加項目	設定方法
新しい注文レポート (TSV)	_GET_FLAT_FILE_ORDERS_DATA_	points-granted	パターンA
未出荷の注文レポート (TSV)	_GET_FLAT_FILE_ACTIONABLE_ORDER_DATA_	points-granted	パターンA
注文レポート (XML)	_GET_ORDER_REPORT_DATA_	points_granted	パターンB

※それぞれのレポートの説明については ReportType列挙子をご確認ください。

設定方法　パターンA

対象ReportType	_GET_FLAT_FILE_ORDERS_DATA_ _GET_FLAT_FILE_ACTIONABLE_ORDER_DATA_

対象ReportType

_GET_FLAT_FILE_ORDERS_DATA_

_GET_FLAT_FILE_ACTIONABLE_ORDER_DATA_

セラーセントラルの注文＞注文レポート画面で、「レポートにAmazonポイントの項目を追加」というボタンをクリックすることで追加いただけます。

※変更後に生成された注文レポートにのみpoints_grantedが追加されます。

これにより以下のように付与されるポイント数がTSV形式の注文レポートに含まれることとなります。

設定方法　パターンB

対象ReportType	_GET_ORDER_REPORT_DATA_

①注文レポートの画面から“列を追加または削除する”をクリック

②注文レポートの項目を追加または削除する画面で、“カスタマイズ情報”および“購入者様に付与されるポイント数”を有効にし、変更を保存する。

※変更後に生成された注文レポートにのみpoints_grantedが追加されます。

これにより以下のように付与されるポイント数がXML形式の注文レポートに含まれることとなります。

    <CustomizationInfo>
        <Type>points_granted</Type>
        <Data>1</Data>
    </CustomizationInfo>

以上、開発時のご参考となれば幸いです。

投稿情報: 15:58 カテゴリー: Amazonポイント, レポートAPI | 個別ページ

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ポイント, 出品管理, 注文管理 | 個別ページ

2014/05/16

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行のレポートを折り返して表示いたしております)

投稿情報: 14:40 カテゴリー: Amazonポイント, レポートAPI, 注文API, 注文管理 | 個別ページ

Amazon マーケットプレイスWebサービス(MWS) 日本公式ブログ

Amazon マーケットプレイスWebサービス(MWS) を利用した、Amazon出品者向けアプリケーション・ソリューションの開発にお役に立つ情報をお届けする公式ブログです。

Amazonポイント

2019/07/04

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

2017/02/28

XMLの注文レポートにAmazonポイント数を表示させる方法について

設定方法　パターンA

設定方法　パターンB

2015/02/20

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

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

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

注文API

商品API

2014/05/16

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

対象注文

変更内容

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

注文レポートの変更点

検索

カテゴリー

最近の記事

アーカイブ

Amazon マーケットプレイスWebサービス(MWS) 日本公式ブログ

Amazon マーケットプレイスWebサービス(MWS) を利用した、Amazon出品者向けアプリケーション・ソリューションの開発にお役に立つ情報をお届けする公式ブログです。

Amazonポイント

2019/07/04

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

2017/02/28

XMLの注文レポートにAmazonポイント数を表示させる方法について

設定方法 パターンA

設定方法 パターンB

2015/02/20

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

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

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

注文API

商品API

2014/05/16

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

対象注文

変更内容

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

注文レポートの変更点

検索

カテゴリー

最近の記事

アーカイブ

設定方法　パターンA

設定方法　パターンB