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マーケットプレイスWebサービス(Amazon MWS)ファイナンスAPIセクションでは次のデータタイプが使用されます。
データタイプ | 説明 |
---|---|
AdjustmentEvent | アカウントの調整。 |
AdjustmentItem | アカウントの調整の項目。 |
ChargeComponent | アカウントに課せられた料金。 |
ChargeInstrument | 支払い方法。 |
CurrencyAmount | 通貨の種類と金額。 |
DebtRecoveryEvent | 負債の支払いまたは負債の調整。 |
DebtRecoveryItem | 負債の支払いまたは負債の調整の項目。 |
DirectPayment | 出品者への直接の支払い。 |
FeeComponent | アカウントに課せられた手数料。 |
FinancialEventGroup | ファイナンスイベントグループに関連する情報。 |
FinancialEvents | ファイナンスイベントに関連するすべての情報。 |
LoanServicingEvent | ローン入金、ローン返済、またはローン返金。 |
PayWithAmazonEvent | Amazonペイメントのアカウントに関連するイベント。 |
PerformanceBondRefundEvent | 中国の出品者が特定のカテゴリーでの出品を停止するときに発行される出品者履行保証金の返金。 |
Promotion | 商品に適用されるプロモーション。 |
RentalTransactionEvent | レンタルトランザクションに関連するイベント。 |
RetrochargeEvent | レトロチャージまたはレトロチャージの取り消し。 |
ServiceFeeEvent | アカウントに課せられたサービス手数料。 |
ShipmentEvent | 配送、返金、保証申請、チャージバック。 |
ShipmentItem | 配送、返金、保証申請、チャージバックの項目。 |
SolutionProviderCreditEvent | ソリューションプロバイダーへの振込額。 |
アカウントの調整。
次の表で、AdjustmentEventデータタイプの要素を示します。
名前 | 説明 |
---|---|
AdjustmentType | AdjustmentTypeの値は次のとおりです。
タイプ:xs:string |
AdjustmentAmount | このイベントの一環として調整された金額。 タイプ: CurrencyAmount |
AdjustmentItemList | AdjustmentItemの値のリスト。 タイプ:リスト - AdjustmentItem |
アカウントの調整の項目。
次の表で、AdjustmentItemデータタイプの要素を示します。
名前 | 説明 |
---|---|
Quantity | AdustmentTypeがFBAInventoryReimbursementの場合の、出品者の在庫のユニット数を表します。 タイプ:xs:int |
PerUnitAmount | 商品のユニット価格。 タイプ: CurrencyAmount |
TotalAmount | 商品の合計金額。 タイプ: CurrencyAmount |
SellerSKU | 商品の出品者SKU。出品者SKUは出品者IDによって限定され、Amazon MWSに対するすべての呼び出しに含められます。 タイプ:xs:string |
FnSKU | Amazonフルフィルメントセンターで保管し、そこから発送される商品にAmazonが割り当てる一意のID。 タイプ:xs:string |
ProductDescription | 商品の短い説明。 タイプ:xs:string |
ASIN | 商品のASIN。 タイプ:xs:string |
アカウントに課せられた料金。
次の表で、ChargeComponentデータタイプの要素を示します。
名前 | 説明 |
---|---|
ChargeType | ChargeTypeの値は次のとおりです。
タイプ:xs:string |
ChargeAmount | 料金の額。 タイプ: CurrencyAmount |
支払い方法。
次の表で、ChargeInstrumentデータタイプの要素を示します。
名前 | 説明 |
---|---|
Description | 課金方法の簡単な説明。 タイプ:xs:string |
Tail | 課金方法のアカウント末尾(最後の数桁)。 タイプ:xs:string |
Amount | この課金方法に課される金額。 タイプ: CurrencyAmount |
通貨の種類と金額。
次の表で、CurrencyAmountデータタイプの要素を示します。
名前 | 説明 |
---|---|
CurrencyCode | ISO 4217フォーマットでの3文字の通貨コード。 タイプ:xs:string |
CurrencyAmount | 金額。 タイプ:xs:decimal |
負債の支払いまたは負債の調整。
次の表で、DebtRecoveryEventデータタイプの要素を示します。
名前 | 説明 |
---|---|
DebtRecoveryType | DebtRecoveryTypeの値は次のとおりです。
タイプ:xs:string |
RecoveryAmount | 回収に適用される金額。 タイプ: CurrencyAmount |
OverPaymentCredit | 過払いに対する返金額。 タイプ: CurrencyAmount |
DebtRecoveryItemList | 清算負債回収項目のリスト。 タイプ:リスト - DebtRecoveryItem |
ChargeInstrumentList | DebtPaymentまたはDebtPaymentFailure回収タイプに使用される課金方法のリスト。 タイプ:リスト - ChargeInstrument |
負債の支払いまたは負債の調整の項目。
次の表で、DebtRecoveryItemデータタイプの要素を示します。
名前 | 説明 |
---|---|
RecoveryAmount | 回収項目に適用される金額。 タイプ: CurrencyAmount |
OriginalAmount | 元の負債金額。 タイプ: CurrencyAmount |
GroupBeginDate | 当該負債を含むファイナンスイベントグループの開始日。ISO 8601日時フォーマット形式。 タイプ:xs:dateTime |
GroupEndDate | 当該負債を含むファイナンスイベントグループの終了日。ISO 8601日時フォーマット形式。 タイプ:xs:dateTime |
出品者への直接の支払い。
次の表で、DirectPaymentデータタイプの要素を示します。
名前 | 説明 |
---|---|
DirectPaymentType | DirectPaymentTypeの値は次のとおりです。
タイプ:xs:string |
DirectPaymentAmount | 直接支払いの金額。 タイプ: CurrencyAmount |
アカウントに課せられた手数料。
次の表で、FeeComponentデータタイプの要素を示します。
名前 | 説明 |
---|---|
FeeType | FeeTypeの値は次のとおりです。
タイプ:xs:string |
FeeAmount | 手数料の額。 タイプ: CurrencyAmount |
ファイナンスイベントグループに関連する情報。
次の表で、FinancialEventGroupデータタイプの要素を示します。
名前 | 説明 |
---|---|
FinancialEventGroupId | ファイナンスイベントグループの一意のID。 タイプ:xs:string |
ProcessingStatus | ファイナンスイベントグループの収支が決済されたかどうかを示す、ファイナンスイベントグループの処理ステータス。 ProcessingStatusの値は次のとおりです。
タイプ:xs:string |
FundTransferStatus | 送金ステータス。 タイプ:xs:string |
OriginalTotal | 対象トランザクションが発生したマーケットプレイスの通貨での合計金額。 タイプ: CurrencyAmount |
ConvertedTotal | 支払われたマーケットプレイスの通貨での合計金額。 タイプ: CurrencyAmount |
FundTransferDate | 支払いまたは課金が開始された日付。完了した決済用にのみ存在しています。ISO 8601日時フォーマット形式。 タイプ:xs:dateTime |
TraceId | 出品者が外部からトランザクションを検索する際に使用される追跡ID。 タイプ:xs:string |
AccountTail | 支払い方法のアカウント末尾。 タイプ:xs:string |
BeginningBalance | 決済期間開始時の残高。 タイプ: CurrencyAmount |
FinancialEventGroupStart | ファイナンスイベントグループが開始された時間。ISO 8601日時フォーマット形式。 タイプ:xs:dateTime |
FinancialEventGroupEnd | ファイナンスイベントグループが終了した時間。ISO 8601日時フォーマット形式。 タイプ:xs:dateTime |
ファイナンスイベントに関連するすべての情報。
次の表で、FinancialEventsデータタイプの要素を示します。
名前 | 説明 |
---|---|
ShipmentEvents | 配送イベントのリスト。 タイプ:リスト - ShipmentEvent |
RefundEvents | 返金イベントのリスト。 タイプ:リスト - ShipmentEvent |
GuaranteeClaimEvents | 保証申請イベントのリスト。 タイプ:リスト - ShipmentEvent |
ChargebackEvents | チャージバックイベントのリスト。 タイプ:リスト - ShipmentEvent |
PayWithAmazonEvents | Amazonペイメントに関するイベントのリスト。 タイプ:リスト - PayWithAmazonEvent |
ServiceProviderCreditEvents | サービスプロバイダーの振込イベントのリスト。 タイプ:リスト - SolutionProviderCreditEvent |
RetrochargeEvents | レトロチャージイベントのリスト。 タイプ:リスト - RetrochargeEvent |
RentalTransactionEvents | レンタルトランザクションイベントのリスト。 タイプ:リスト - RentalTransactionEvent |
PerformanceBondRefundEvents | 履行補償金の返金イベントのリスト。 タイプ:リスト - PerformanceBondRefundEvent |
ServiceFeeEvents | サービス手数料イベントのリスト。 タイプ:リスト - ServiceFeeEvent |
DebtRecoveryEvents | 負債回収イベントのリスト。 タイプ:リスト - DebtRecoveryEvent |
LoanServicingEvents | ローンサービスイベントのリスト。 タイプ:リスト - LoanServicingEvent |
AdjustmentEvents | 調整イベントのリスト。 タイプ:リスト - AdjustmentEvent |
ローン入金、ローン返済、またはローン返金。
次の表で、LoanServicingEventデータタイプの要素を示します。
名前 | 説明 |
---|---|
LoanAmount | ローン金額。 タイプ: CurrencyAmount |
SourceBusinessEventType | SourceBusinessEventTypeの値は次のとおりです。
タイプ:xs:string |
Amazonペイメントのアカウントに関連するイベント。
次の表で、PayWithAmazonEventデータタイプの要素を示します。
名前 | 説明 |
---|---|
SellerOrderId | 出品者によって指定される注文番号。 タイプ:xs:string |
TransactionPostedDate | 支払いトランザクションがポストされた日付。ISO 8601日時フォーマット形式。 タイプ:xs:dateTime |
BusinessObjectType | BusinessObjectTypeの値は次のとおりです。
タイプ:xs:string |
SalesChannel | トランザクションの販売チャネル。 タイプ:xs:string |
Charge | イベントに関連付けられた料金。 タイプ: ChargeComponent |
FeeList | イベントに関連付けられた手数料のリスト。 タイプ:リスト - FeeComponent |
PaymentAmountType | PaymentAmountTypeの値は次のとおりです。
タイプ:xs:string |
AmountDescription | この支払いイベントの簡単な説明。 タイプ:xs:string |
FulfillmentChannel | FulfillmentChannelの値は次のとおりです。
タイプ:xs:string |
StoreName | イベントが発生した店舗名。 タイプ:xs:string |
中国の出品者が特定のカテゴリーでの出品を停止するときに発行される出品者履行保証金の返金。
次の表で、PerformanceBondRefundEventデータタイプの要素を示します。
名前 | 説明 |
---|---|
MarketplaceCountryCode | マーケットプレイスに関連付けられている国の2文字のコード。
タイプ:xs:string |
Amount | Amazonが出品者に返金する額。 タイプ: CurrencyAmount |
ProductGroupList | 出品者が出品を停止した商品カテゴリーのリスト。 タイプ:xs:stringのリスト |
商品に適用されるプロモーション。
次の表で、Promotionデータタイプの要素を示します。
名前 | 説明 |
---|---|
PromotionType | プロモーションのタイプ。 タイプ:xs:string |
PromotionId | 出品者によって指定されるプロモーションID。 タイプ:xs:string |
PromotionAmount | 商品に適用されるプロモーション割引の金額。 タイプ: CurrencyAmount |
レンタルトランザクションに関連するイベント。
次の表で、RentalTransactionEventデータタイプの要素を示します。
名前 | 説明 |
---|---|
AmazonOrderId | Amazonによって定義される注文番号。 タイプ:xs:string |
RentalEventType | RentalEventTypeの値は次のとおりです。
タイプ:xs:string |
ExtensionLength | すでにレンタル中の商品のレンタル期間を購入者が延長した日数。値が返されるのはRentalCustomerPayment-ExtensionとRentalCustomerRefund-Extensionイベントのみです。 タイプ:xs:int |
PostedDate | レンタルイベントがポストされた日付。ISO 8601日時フォーマット形式。 タイプ:xs:dateTime |
RentalChargeList | レンタルイベントに関連付けられた料金のリスト。 タイプ:リスト - ChargeComponent |
RentalFeeList | レンタルイベントに関連付けられた手数料のリスト。 タイプ:リスト - FeeComponent |
MarketplaceName | マーケットプレイスの名称。 タイプ:xs:string |
RentalInitialValue | 顧客が商品をレンタルするために最初に支払った金額。値が返されるのはRentalChargeFailureReimbursementとRentalLostItemReimbursementイベントのみです。 タイプ: CurrencyAmount |
RentalReimbursement | 商品の紛失または請求の不備への補償として、Amazonが出品者に送金する金額。値が返されるのはRentalChargeFailureReimbursementとRentalLostItemReimbursementイベントのみです。 タイプ: CurrencyAmount |
レトロチャージまたはレトロチャージの取り消し。
次の表で、RetrochargeEventデータタイプの要素を示します。
名前 | 説明 |
---|---|
RetrochargeEventType | RetrochargeEventTypeの値は次のとおりです。
タイプ:xs:string |
AmazonOrderId | Amazonによって定義される注文ID。 タイプ:xs:string |
PostedDate | レトロチャージイベントがポストされた日付。ISO 8601日時フォーマット形式。 タイプ:xs:dateTime |
BaseTax | レトロチャージイベントに関連付けられた基本税額。 タイプ: CurrencyAmount |
ShippingTax | レトロチャージイベントに関連付けられた配送料の税額。 タイプ: CurrencyAmount |
MarketplaceName | レトロチャージイベントが発生したマーケットプレイスの名称。 タイプ:xs:string |
アカウントに課せられたサービス手数料。
次の表で、ServiceFeeEventデータタイプの要素を示します。
名前 | 説明 |
---|---|
AmazonOrderId | Amazonによって定義される注文ID。 タイプ:xs:string |
FeeReason | サービス手数料の事由の簡単な説明。 タイプ:xs:string |
FeeList | サービス手数料に関連付けられた手数料コンポーネントのリスト。 タイプ:リスト - FeeComponent |
SellerSKU | 商品の出品者SKU。出品者SKUは出品者IDによって限定され、Amazon MWSに対するすべての呼び出しに含められます。 タイプ:xs:string |
FnSKU | Amazonフルフィルメントセンターで保管し、そこから発送される商品にAmazonが割り当てる一意のID。 タイプ:xs:string |
FeeDescription | サービス手数料イベントの簡単な説明。 タイプ:xs:string |
ASIN | 商品のASIN。 タイプ:xs:string |
配送、返金、保証申請、チャージバック。
次の表で、ShipmentEventデータタイプの要素を示します。
名前 | 説明 |
---|---|
AmazonOrderId | Amazonによって定義される注文ID。 タイプ:xs:string |
SellerOrderId | 出品者によって定義される注文ID。 タイプ:xs:string |
MarketplaceName | イベントが発生したマーケットプレイスの名称。 タイプ:xs:string |
OrderChargeList | 注文レベルの料金のリスト。これらの料金はFBAマルチチャネルサービス(MCF)のCOD注文に適用できます。 タイプ:リスト - ChargeComponent |
OrderChargeAdjustmentList | 注文レベルの料金調整のリスト。これらの調整はFBAマルチチャネルサービス(MCF)のCOD注文に適用できます。 タイプ:リスト - ChargeComponent |
ShipmentFeeList | 出荷レベルの料金のリスト。 タイプ:リスト - FeeComponent |
ShipmentFeeAdjustmentList | 出荷レベルの手数料調整のリスト。 タイプ:リスト - FeeComponent |
OrderFeeList | 注文レベルの手数料のリスト。これらの料金はFBAマルチチャネルサービス(MCF)の注文に適用できます。 タイプ:リスト - FeeComponent |
OrderFeeAdjustmentList | 注文レベルの手数料調整のリスト。これらの調整はFBAマルチチャネルサービス(MCF)の注文に適用できます。 タイプ:リスト - FeeComponent |
DirectPaymentList | 購入者がAmazon提供のクレジットカードのいずれかを使ってAmazonに支払うか、代金引換を通じて購入者が出品者に直接支払う場合のトランザクションのリスト。 タイプ:リスト - DirectPayment |
PostedDate | ファイナンスイベントが作成された日付。ISO 8601日時フォーマット形式。 タイプ:xs:dateTime |
ShipmentItemList | 配送商品のリスト。 タイプ:リスト - ShipmentItem |
ShipmentItemAdjustmentList | 配送商品の調整のリスト。 タイプ:リスト - ShipmentItem |
配送、返金、保証申請、チャージバックの項目。
次の表で、ShipmentItemデータタイプの要素を示します。
名前 | 説明 |
---|---|
SellerSKU | 商品の出品者SKU。出品者SKUは出品者IDによって限定され、Amazon MWSに対するすべての呼び出しに含められます。 タイプ:xs:string |
OrderItemId | Amazonによって定義される注文商品ID。 タイプ:xs:string |
OrderAdjustmentItemId | Amazonが返金、保証申請、チャージバックイベントのために定義した注文調整のID。 タイプ:xs:string |
QuantityShipped | 発送された商品の数。 タイプ:xs:int |
ItemChargeList | 配送商品に関連付けられた料金のリスト。 タイプ:リスト - ChargeComponent |
ItemChargeAdjustmentList | 配送商品に関連付けられた料金調整のリスト。この値が返されるのは返金、保証申請、チャージバックイベントのみです。 タイプ:リスト - ChargeComponent |
ItemChargeAdjustmentList | 配送商品に関連付けられた料金調整のリスト。この値が返されるのは返金、保証申請、チャージバックイベントのみです。 タイプ:リスト - ChargeComponent |
ItemFeeList | 配送商品に関連付けられた手数料のリスト。 タイプ:リスト - FeeComponent |
ItemFeeAdjustmentList | 配送商品に関連付けられた手数料調整のリスト。この値が返されるのは返金、保証申請、チャージバックイベントのみです。 タイプ:リスト - FeeComponent |
PromotionList | 配送商品に関連付けられたプロモーションのリスト。 タイプ:リスト - Promotion |
PromotionAdjustmentList | 配送商品に関連付けられたプロモーション調整のリスト。この値が返されるのは返金、保証申請、チャージバックイベントのみです。 タイプ:リスト - Promotion |
CostOfPointsGranted | 配送商品に付与されるAmazonポイントのコスト。 タイプ: CurrencyAmount |
CostOfPointsReturned | 配送商品に返還されるAmazonポイントのコスト。この値が返されるのは返金、保証申請、チャージバックイベントのみです。 タイプ: CurrencyAmount |
ソリューションプロバイダーへの振込額。
次の表で、SolutionProviderCreditEventデータタイプの要素を示します。
名前 | 説明 |
---|---|
ProviderTransactionType | ProviderTransactionTypeの値は次のとおりです。
タイプ:xs:string |
SellerOrderId | 出品者によって定義される注文ID。 タイプ:xs:string |
MarketplaceId | 注文が実行されたマーケットプレイスのID。 タイプ:xs:string |
MarketplaceCountryCode | 注文が実行されたマーケットプレイスに関連付けられている国の2文字のコード。 タイプ:xs:string |
SellerId | Amazonによって定義される出品者ID。 タイプ:xs:string |
SellerStoreName | 支払いイベントが発生した店舗名。 タイプ:xs:string |
ProviderId | Amazonによって定義されるソリューションプロバイダーID。 タイプ:xs:string |
ProviderStoreName | 支払いイベントが発生した店舗名。 タイプ:xs:string |