Amazon Services Japan
Amazonマーケットプレイス Web サービス (Amazon MWS) ドキュメント

Deprecation Notice:

Amazon Marketplace Web Service (MWS) will no longer be available after March 31, 2024. All MWS developers must migrate to Selling Partner API (SP-API) to avoid service disruptions. Refer to the Migration Hub for more information.

Amazon MWS ドキュメント

商品データタイプ

AmazonマーケットプレイスWebサービス(Amazon MWS) 商品APIセクションのレスポンス要素では、以下のデータタイプを使用します。

データタイプ 説明
AvailabilityType 商品が現在出荷可能か、 出荷予定日がわかっているか、出荷日が未定であるかを示す。
BuyBoxPrice ショッピングカートボックスに表示される商品の価格。
DetailedShippingTimeType 注文から商品が出荷できるようになるまでの最大時間。
FeeDetail 手数料のタイプ、手数料の金額、その他の詳細。
FeesEstimate 商品の合計手数料見積もり額および詳細のリスト。
FeesEstimateIdentifier 商品ID、マーケットプレイス、リクエスト日時、見積もりに関するその他の詳細。
FeesEstimateRequest 手数料見積もり額のリクエストに使用される商品、マーケットプレイス、提案価格。
FeesEstimateResult 商品IDとその商品の手数料見積もり額。
FeeType 出品者に請求される手数料のタイプ。
FulfillmentChannelType Amazonから出荷する商品であるか、出品者から出荷する商品であるかを示す。
LowestPrice 商品の最低価格。
MarketplaceType 暗号化された、Amazonが定義したマーケットプレイスID
MoneyType 指定した通貨で表された金額。
OfferCount 指定したコンディションに応じた、フルフィルメントチャネルごとの出品数。
OfferCountType 指定したコンディションとフルフィルメントチャネルの出品数。
Points 商品の購入で獲得するAmazonポイント数。
PriceToEstimateFees 手数料の見積もりに使用された、商品の価格情報。
SellerFeedbackRating 出品者のフィードバックに関する情報(良い評価を受けた割合および寄せられたフィードバックの総数)。
ShipsFrom 商品の発送元の都道府県および国。

AvailabilityType

商品が現在出荷可能か、 出荷予定日がわかっているか、出荷日が未定であるかを示す。

タイプ:xs:string

値:

  • NOW - 現在出荷可能な商品。
  • FUTURE_WITHOUT_DATE - 商品の入荷予定日は未定です。
  • FUTURE_WITH_DATE - 商品の入荷予定日が決まっています。

BuyBoxPrice

ショッピングカートボックスに表示される商品の価格。

BuyBoxPrice属性

名前 説明 必須
condition 商品のコンディションを表示します。例:NewUsedCollectibleRefurbishedClub はい タイプ:xs:string

BuyBoxPrice要素

名前 説明 必須
LandedPrice 商品価格 + 配送料 - 獲得するAmazonポイント数。 はい タイプ: MoneyType
ListingPrice 商品の価格。 はい タイプ: MoneyType
Shipping 配送料。 はい タイプ: MoneyType
Points 商品の購入で獲得するAmazonポイント数。 いいえ タイプ: Points

DetailedShippingTimeType

注文から商品が出荷できるようになるまでの時間。

DetailedShippingTimeType属性

名前 説明 必須
minimumHours 注文があってから商品が出荷できるようになるまでの最短時間(時間単位)。 いいえ タイプ:xs:short
maximumHours 注文があってから商品が出荷できるようになるまでの最長時間(時間単位)。 いいえ タイプ:xs:short
availableDate 商品の出荷予定日。現在出荷できない商品にのみ表示。 いいえ ISO 8601日時フォーマット

タイプ:xs:dateTime

availabilityType 商品が現在出荷可能か、 出荷予定日がわかっているか、出荷日が未定であるかを示す。 出荷予定日がわかっている場合、availableDate属性は商品の出荷予定日を示します。 いいえ タイプ: AvailabilityType

FeeDetail

手数料のタイプ、手数料の金額、その他の詳細。

FeeDetail要素

手数料の詳細については、セラーセントラルの手数料見積り額FBA - 機能と手数料を参照してください。

名前 説明 必須
FeeType 出品者に請求される手数料のタイプ。 はい タイプ: FeeType
FeeAmount 手数料の請求金額。 はい タイプ: MoneyType
FeePromotion 手数料のプロモーション金額。 いいえ タイプ: MoneyType
TaxAmount 手数料の税額。これはインドのマーケットプレイスでのみ表示されます。 いいえ タイプ: MoneyType
FinalFee 手数料の最終的な金額。 はい タイプ: MoneyType
IncludedFeeDetailList 手数料に適用されるその他の手数料のリスト。 いいえ タイプ:タイプのリスト: FeeDetail

FeesEstimate

商品の合計手数料見積もり額および詳細のリスト。

FeesEstimate要素

名前 説明 必須
TotalFeesEstimate 各商品、価格、フルフィルメントチャネルに対する手数料見積り額の合計。 はい タイプ: MoneyType
FeeDetailList 手数料に適用されるその他の手数料のリスト。 はい タイプ:タイプのリスト: FeeDetail

FeesEstimateIdentifier

商品ID、マーケットプレイス、リクエスト日時、見積もりに関するその他の詳細。

FeesEstimateIdentifier要素

名前 説明 必須
MarketplaceId 暗号化された、Amazonが定義したマーケットプレイスID はい タイプ: MarketplaceType
IdType IdValueで使用される商品IDのタイプ。 はい IdType値:ASINSellerSKU

タイプ:xs:string

IdValue 商品ID。 はい タイプ:xs:string
PriceToEstimateFees 手数料の見積もりの基準となる商品価格。 はい タイプ: PriceToEstimateFees
IsAmazonFulfilled フルフィルメント by Amazonで出品する場合は true はい タイプ:xs:boolean
SellerInputIdentifier このリクエストを追跡するために送信者が指定した一意のID。 はい タイプ:xs:string
TimeOfFeesEstimation 手数料の見積もり日時。通常はリクエストされた日時になります。 はい タイプ:xs:dateTime

FeesEstimateRequest

手数料見積もり額のリクエストに使用される商品、マーケットプレイス、提案価格。

FeesEstimateRequest要素

名前 説明 必須
MarketplaceId 暗号化された、Amazonが定義したマーケットプレイスID はい タイプ: MarketplaceType
IdType IdValueで使用される商品IDのタイプ。 はい IdType値:ASINSellerSKU

タイプ:xs:string

IdValue 商品ID。 はい タイプ:xs:string
PriceToEstimateFees 手数料の見積もりの基準となる商品価格。 はい タイプ: PriceToEstimateFees
Identifier このリクエストを識別するための一意の値。 はい タイプ:xs:string
IsAmazonFulfilled フルフィルメント by Amazonで出品する場合は true はい タイプ:xs:boolean

FeesEstimateResult

商品IDとその商品の手数料見積もり額。

FeesEstimateResult要素

名前 説明 必須
FeesEstimateIdentifier 商品手数料リクエストを識別するための情報。 はい タイプ: FeesEstimateIdentifier
FeesEstimate 商品の合計手数料見積もり額および詳細のリスト。 いいえ タイプ: FeesEstimate
Status 手数料リクエストのステータス はい Status値:SuccessClientErrorServiceError

タイプ:xs:string

Error タイプ、コード、メッセージで構成されるエラーオブジェクト。 いいえ タイプ:エラー

StatusまたはError要素の取り扱いについては、一括オペレーションリクエストを実行するを参照してください。

FeeType

出品者に請求される手数料のタイプ。

タイプ:xs:string

値:

  • ReferralFee
  • VariableClosingFee
  • PerItemFee
  • FBAFees
  • FBAPickAndPack
  • FBAWeightHandling
  • FBAOrderHandling
  • FBADeliveryServicesFee

FulfillmentChannelType

Amazonから出荷する商品であるか、出品者から出荷する商品であるかを示す。

タイプ:xs:string

値:

  • Amazon
  • Merchant

LowestPrice

商品の最低価格。

LowestPrice属性

名前 説明 必須
condition 商品のコンディションを表示します。例:NewUsedCollectibleRefurbishedClub はい タイプ:xs:string
fulfillmentChannel Amazonから出荷する商品であるか、出品者から出荷する商品であるかを示す。 はい タイプ: FulfillmentChannelType

LowestPrice要素

名前 説明 必須
LandedPrice 商品価格 + 配送料 - 獲得するAmazonポイント数。 はい タイプ: MoneyType
ListingPrice 商品の価格。 はい タイプ: MoneyType
Shipping 配送料。 はい タイプ: MoneyType
Points 商品の購入で獲得するAmazonポイント数。 いいえ タイプ: Points

MarketplaceType

暗号化された、Amazonが定義したマーケットプレイスID

タイプ:xs:string

制限値:[A-Z0-9]+

MarketplaceId値の一覧については、Amazon MWS開発者ガイドAmazon MWSエンドポイントとMarketplaceId値を参照してください。

MoneyType

指定した通貨で表された金額。

MoneyType要素

名前 説明 必須
Amount 合計金額。 いいえ タイプ:xs:decimal

ゼロより大きい10進数の値。

CurrencyCode ISO 4217フォーマットの通貨コード。 いいえ タイプ:xs:string
次のいずれか:
  • USD (米ドル)
  • EUR (ヨーロッパユーロ)
  • GBP (英ポンド)
  • RMB (中国元)
  • INR (インドルピー)
  • JPY (日本円)
  • CAD (カナダドル)
  • MXN (メキシコペソ)

OfferCount

指定したコンディションに応じた、フルフィルメントチャネルごとの出品数。

OfferCount属性

名前 説明 必須
condition 商品のコンディションを表示します。例:NewUsedCollectibleRefurbishedClub はい タイプ:xs:string
fulfillmentChannel Amazonから出荷する商品であるか、出品者から出荷する商品であるかを示す。 はい タイプ: FulfillmentChannelType

OfferCount要素

OfferCount要素には子要素がありません。OfferCount要素はタイプ:xs:intの拡張型です。

OfferCountType

指定したコンディションとフルフィルメントチャネルの出品数。

OfferCountType要素

名前 説明 必須
OfferCount 指定したコンディションに応じた、フルフィルメントチャネルごとの出品数。 いいえ タイプ: OfferCount

Points

商品の購入で獲得するAmazonポイント数。 Amazonポイントプログラムは日本限定です。

Points要素

名前 説明 必須
PointsNumber Amazonポイントの数。 はい タイプ:xs:int

PriceToEstimateFees

手数料の見積もりに使用された、商品の価格情報。

PriceToEstimateFees要素

名前 説明 必須
ListingPrice 商品の価格。 はい タイプ: MoneyType
Shipping 配送料。 いいえ タイプ: MoneyType
Points 商品の購入で獲得するAmazonポイント数。 いいえ タイプ: Points

SellerFeedbackRating

出品者のフィードバックに関する情報(良い評価を受けた割合および寄せられたフィードバックの総数)。

SellerFeedbackRating要素

名前 説明 必須
SellerPositiveFeedbackRating 過去365日間に出品者が良い評価を受けた割合。 いいえ タイプ:xs:double
FeedbackCount 出品者に関するフィードバックの数。 はい タイプ:xs:long

ShipsFrom

商品の発送元の都道府県および国。

ShipsFrom要素

名前 説明 必須
State 商品の発送元の都道府県。 いいえ タイプ:xs:string
Country 商品の発送元の国。 いいえ タイプ:xs:string