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.
指定した注文、ファイナンスイベントグループ、または期間のファイナンスイベントを返します。
ListFinancialEventsオペレーションは、リクエストで指定されたフィルターに一致するファイナンスイベントのリストを返します。
ファイナンスイベントグループID、期間、注文番号でフィルターできます。リクエストでファイナンスイベントグループIDを指定すると、そのファイナンスイベントグループに含まれるすべてのファイナンスイベントが返されます。リクエストで時間の範囲を指定すると、その期間にポストされたすべてのファイナンスイベントが返されます。リクエストで注文番号を指定すると、その注文に含まれるすべてのファイナンスイベントが返されます。
このオペレーションはすべてのマーケットプレイスで利用できます。
このオペレーションの最大リクエストクォータは30回で、回復レートは2秒につき1リクエストです。スロットリング用語の定義およびスロットルの詳しい説明については、Amazon MWS開発者ガイドのスロットリング:リクエストの送信頻度を制限するを参照してください。
すべてのAmazon MWSオペレーションで必須のリクエストパラメーターについては、Amazon MWS開発者ガイドの必須のリクエストパラメーターを参照してください。
名前 | 説明 | 必須 | 有効値 |
---|---|---|---|
MaxResultsPerPage | ページあたりの返される結果の最大数。 | いいえ | 最小:1 最大:100 デフォルト:100 タイプ:xs:int |
AmazonOrderId | 注文番号。指定すると該当するすべてのファイナンスイベントを返します。 | 次のフィルター条件のうち1つのみを指定できます。
|
Amazonの有効な注文番号(3桁-7桁-7桁の形式)。 タイプ:xs:string |
FinancialEventGroupId | ファイナンスイベントグループID。指定すると該当するすべてのファイナンスイベントを返します。 | 次のフィルター条件のうち1つのみを指定できます。
|
ファイナンスイベントグループの有効なID。 タイプ:xs:string |
PostedAfter | ある時刻以降にポストされたファイナンスイベントを選択するために指定する日時。 | 次のフィルター条件のうち1つのみを指定できます。
|
リクエストの送信時刻の2分前より前の有効な日時(ISO 8601日時フォーマット形式)。 タイプ:xs:dateTime |
PostedBefore | ある時刻より前(その時刻は含まない)にポストされたファイナンスイベントを選択するために指定する日時。 | 次のフィルター条件のうち1つのみを指定できます。
|
PostedAfterより後で、リクエストの送信時刻の2分前より前の有効な日時(ISO 8601日時フォーマット形式)。PostedAfterと
PostedBeforeの間隔が180日より長い場合、
ファイナンスイベントは返却されません。このリクエストパラメーターを指定する場合は、PostedAfterリクエストパラメーターを指定する必要があります。 デフォルト:現時刻から2分を引いた日時。 タイプ:xs:dateTime |
名前 | 説明 |
---|---|
NextToken | 次回のリクエストに対して情報を渡すために使用される生成文字列。NextTokenが返された場合、NextTokenの値をListFinancialEventsByNextTokenに渡します。NextTokenが返されない場合、これ以上返されるファイナンスイベントはありません。 任意 タイプ:xs:string |
FinancialEvents | リクエストで指定した条件を満たすファイナンスイベントが含まれます。 タイプ: FinancialEvents |
標準のリクエスト要件について詳しくは、必須のリクエストパラメーターを参照してください。
POST /Finances/2015-05-01 HTTP/1.1 Content-Type: x-www-form-urlencoded Host: mws.amazonservices.com User-Agent: <Your User Agent Header> AWSAccessKeyId=0PB842EXAMPLESDX &Action=ListFinancialEvents &AmazonOrderId=333-7777777-7777777 &MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE &SellerId=A1XEXAMPLEDF &SignatureMethod=HmacSHA256 &SignatureVersion=2 &Timestamp=2015-05-01T18%3A12%3A21.687Z &Version=2015-05-01 &Signature=ZQLpf8vEXAMPLE0iC265pf18n0%3D
標準のレスポンスフォーマットについて詳しくは、レスポンスフォーマットを参照してください。
<?xml version="1.0"?> <ListFinancialEventsResponse xmlns="https://mws.amazonservices.com/Finances/2015-05-01"> <ListFinancialEventsResult> <NextToken>2YgYW55IGNhcm5hbCBwbGVhcEXAMPLE</NextToken> <FinancialEvents> <ShipmentEventList> <ShipmentEvent> <AmazonOrderId>333-1234567-1234567</AmazonOrderId> <SellerOrderId>333-1234567-7654321</SellerOrderId> <MarketplaceName>amazon.com</MarketplaceName> <OrderChargeList> <OrderCharge> <ChargeType>Principal</ChargeType> <ChargeAmount> <CurrencyCode>USD</CurrencyCode> <Amount>10.0</Amount> </ChargeAmount> </OrderCharge> <OrderCharge> <ChargeType>Tax</ChargeType> <ChargeAmount> <CurrencyCode>USD</CurrencyCode> <Amount>1.0</Amount> </ChargeAmount> </OrderCharge> </OrderChargeList> <ShipmentFeeList> <ShipmentFee> <FeeType>FBAStorageFee</FeeType> <FeeAmount> <CurrencyCode>USD</CurrencyCode> <Amount>-1.0</Amount> </FeeAmount> </ShipmentFee> </ShipmentFeeList> <OrderFeeList> <OrderFee> <FeeType>LabellingFee</FeeType> <FeeAmount> <CurrencyCode>USD</CurrencyCode> <Amount>-1.0</Amount> </FeeAmount> </OrderFee> </OrderFeeList> <FulfillmentList> <PostedDate>2012-07-18T00:00:00Z</PostedDate> <DirectPaymentList> <DirectPayment> <DirectPaymentType>StoredValuedCardRevenue</DirectPaymentType> <DirectPaymentAmount> <CurrencyCode>USD</CurrencyCode> <Amount>1.0</Amount> </DirectPaymentAmount> </DirectPayment> </DirectPaymentList> <ShipmentItemList> <ShipmentItem> <SellerSKU>CBA_OTF_1</SellerSKU> <OrderItemId>6882857EXAMPLE</OrderItemId> <QuantityShipped>2</QuantityShipped> <ItemChargeList> <ItemCharge> <ChargeType>Discount</ChargeType> <ChargeAmount> <CurrencyCode>USD</CurrencyCode> <Amount>1.99</Amount> </ChargeAmount> </ItemCharge> </ItemChargeList> <ItemFeeList> <ItemFee> <FeeType>FBAStorageFee</FeeType> <FeeAmount> <CurrencyCode>USD</CurrencyCode> <Amount>-1.99</Amount> </FeeAmount> </ItemFee> </ItemFeeList> <PromotionList> <Promotion> <PromotionType>Shipping</PromotionType> <PromotionId>SummerEXAMPLE</PromotionId> <PromotionAmount> <CurrencyCode>USD</CurrencyCode> <Amount>-15.99</Amount> </PromotionAmount> </Promotion> </PromotionList> <CostOfPointsGranted> <CurrencyCode>USD</CurrencyCode> <Amount>-5.99</Amount> </CostOfPointsGranted> </ShipmentItem> </ShipmentItemList> </FulfillmentList> </ShipmentEvent> </ShipmentEventList> <RefundEventList> <ShipmentEvent> <SellerOrderId>333-7654321-7654321</SellerOrderId> <MarketplaceName>amazon.com</MarketplaceName> <OrderChargeAdjustmentList> <OrderChargeAdjustment> <ChargeType>ShippingCharge</ChargeType> <ChargeAmount> <CurrencyCode>USD</CurrencyCode> <Amount>-1.99</Amount> </ChargeAmount> </OrderChargeAdjustment> <OrderChargeAdjustment> <ChargeType>Giftwrap</ChargeType> <ChargeAmount> <CurrencyCode>USD</CurrencyCode> <Amount>-0.99</Amount> </ChargeAmount> </OrderChargeAdjustment> </OrderChargeAdjustmentList> <ShipmentFeeAdjustmentList> <ShipmentFeeAdjustment> <FeeType>FBADeliveryServicesFee</FeeType> <FeeAmount> <CurrencyCode>USD</CurrencyCode> <Amount>1.99</Amount> </FeeAmount> </ShipmentFeeAdjustment> <ShipmentFeeAdjustment> <FeeType>FBAPlacementServiceFee</FeeType> <FeeAmount> <CurrencyCode>USD</CurrencyCode> <Amount>0.99</Amount> </FeeAmount> </ShipmentFeeAdjustment> </ShipmentFeeAdjustmentList> <OrderFeeAdjustmentList> <OrderFeeAdjustment> <FeeType>FBAInventoryReturnFee</FeeType> <FeeAmount> <CurrencyCode>USD</CurrencyCode> <Amount>1.99</Amount> </FeeAmount> </OrderFeeAdjustment> </OrderFeeAdjustmentList> <FulfillmentList> <PostedDate>2012-07-18T00:00:00Z</PostedDate> <ShipmentItemAdjustmentList> <ShipmentItemAdjustment> <SellerSKU>CBA_OTF_1</SellerSKU> <OrderAdjustmentItemId>6882857EXAMPLE</OrderAdjustmentItemId> <QuantityShipped>4</QuantityShipped> <ItemChargeAdjustmentList> <ItemCharge> <ChargeType>ReturnShipping</ChargeType> <ChargeAmount> <CurrencyCode>USD</CurrencyCode> <Amount>-1.99</Amount> </ChargeAmount> </ItemCharge> </ItemChargeAdjustmentList> <ItemFeeAdjustmentList> <ItemFee> <FeeType>ShippingChargeback</FeeType> <FeeAmount> <CurrencyCode>USD</CurrencyCode> <Amount>2.99</Amount> </FeeAmount> </ItemFee> </ItemFeeAdjustmentList> <PromotionAdjustmentList> <Promotion> <PromotionType>Shipping</PromotionType> <PromotionId>Summer099018</PromotionId> <PromotionAmount> <CurrencyCode>USD</CurrencyCode> <Amount>22.99</Amount> </PromotionAmount> </Promotion> </PromotionAdjustmentList> <CostOfPointsReturned> <CurrencyCode>USD</CurrencyCode> <Amount>5.99</Amount> </CostOfPointsReturned> </ShipmentItemAdjustment> </ShipmentItemAdjustmentList> </FulfillmentList> </ShipmentEvent> </RefundEventList> <PayWithAmazonEventList> <PayWithAmazonEvent> <SellerOrderId>333-7654321-7654321</SellerOrderId> <TransactionPostedDate> 2013-09-071T02:00:00.000-06:00 </TransactionPostedDate> <BusinessObjectType>PaymentContract</BusinessObjectType> <SalesChannel>www.merchantsite.com</SalesChannel> <Charge> <ChargeType>Principal</ChargeType> <ChargeAmount> <CurrencyCode>USD</CurrencyCode> <Amount>2.99</Amount> </ChargeAmount> </Charge> <FeeList> <Fee> <FeeType>VariableClosingFee</FeeType> <FeeAmount> <CurrencyCode>USD</CurrencyCode> <Amount>-0.99</Amount> </FeeAmount> </Fee> </FeeList> <PaymentAmountType>Sales</PaymentAmountType> <AmountDescription>Pay with amazon transaction</AmountDescription> <FulfillmentNetwork>MFN</FulfillmentNetwork> <StoreName>TestStoreName</StoreName> </PayWithAmazonEvent> </PayWithAmazonEventList> <SolutionProviderCreditEventList> <SolutionProviderCreditEvent> <ProviderTransactionType> SolutionProviderCredit </ProviderTransactionType> <SellerOrderId>333-7654321-7654321</SellerOrderId> <MarketplaceId>12</MarketplaceId> <MarketplaceCountryCode>US</MarketplaceCountryCode> <TransactionAmount> <CurrencyCode>USD</CurrencyCode> <Amount>22.99</Amount> </TransactionAmount> <SellerId>987918809</SellerId> <SellerStoreName>TestSellerStoreName</SellerStoreName> <ProviderId>6798769889</ProviderId> <ProviderStoreName>TestProviderStoreName</ProviderStoreName> </SolutionProviderCreditEvent> </SolutionProviderCreditEventList> <RetrochargeEventList> <RetrochargeEvent> <RetrochargeEventType>Retrocharge</RetrochargeEventType> <AmazonOrderId>333-1234567-1234567</AmazonOrderId> <PostedDate>2013-09-071T02:00:00.000-06:00</PostedDate> <BaseTax> <CurrencyCode>USD</CurrencyCode> <Amount>1.99</Amount> </BaseTax> <ShippingTax> <CurrencyCode>USD</CurrencyCode> <Amount>2.99</Amount> </ShippingTax> <MarketplaceName>amazon.com</MarketplaceName> </RetrochargeEvent> </RetrochargeEventList> <RentalTransactionEventList> <RentalTransaction> <AmazonOrderId>333-1234567-1234567</AmazonOrderId> <RentalTransactionType> RentalCustomerPayment-Buyout </RentalTransactionType> <PostedDate>2013-09-071T02:00:00.000-06:00</PostedDate> <ExtensionLength>12</ExtensionLength> <RentalChargeList> <ChargeType>Tax</ChargeType> <ChargeAmount> <CurrencyCode>USD</CurrencyCode> <Amount>0.99</Amount> </ChargeAmount> </RentalChargeList> <RentalFeeList> <FeeType>SalesTaxServiceFee</FeeType> <FeeAmount> <CurrencyCode>USD</CurrencyCode> <Amount>-1.99</Amount> </FeeAmount> </RentalFeeList> <MarketplaceName>amazon.com</MarketplaceName> <RentalInitialValue> <CurrencyCode>USD</CurrencyCode> <Amount>3.99</Amount> </RentalInitialValue> <RentalReimbursement> <CurrencyCode>USD</CurrencyCode> <Amount>1.99</Amount> </RentalReimbursement> </RentalTransaction> </RentalTransactionEventList> <PerformanaceBondRefundEventList> <PerformanceBondRefundEvent> <MarketplaceCountryCode>US</MarketplaceCountryCode> <Amount> <CurrencyCode>USD</CurrencyCode> <Amount>1.99</Amount> </Amount> <ProductGroupList> <GLProductGroup> <GLName>gl_books</GLName> <TranslatorStringId> string_translator_id_6982708 </TranslatorStringId> </GLProductGroup> </ProductGroupList> </PerformanceBondRefundEvent> </PerformanaceBondRefundEventList> <ServiceFeeEventList> <ServiceFeeEvent> <AmazonOrderId>333-1234567-1234567</AmazonOrderId> <FeeReason>fba inbound defect fee</FeeReason> <FeeList> <Fee> <FeeType>FBAOrderHandlingFee</FeeType> <FeeAmount> <CurrencyCode>USD</CurrencyCode> <Amount>-0.99</Amount> </FeeAmount> </Fee> </FeeList> <SellerSKU>CBA_OF_1</SellerSKU> <FNSKU>AKSJD12</FNSKU> <FeeDescription>Test Fee description</FeeDescription> <ASIN>BT0093TELA</ASIN> </ServiceFeeEvent> </ServiceFeeEventList> <DebtRecoveryEventList> <DebtRecoveryEvent> <DebtRecoveryType>DebtAdjustment</DebtRecoveryType> <RecoveryAmount> <CurrencyCode>USD</CurrencyCode> <Amount>10.99</Amount> </RecoveryAmount> <OverPaymentCredit> <CurrencyCode>USD</CurrencyCode> <Amount>8.99</Amount> </OverPaymentCredit> <DebtRecoveryItemList> <DebtRecoveryItem> <RecoveryAmount> <CurrencyCode>USD</CurrencyCode> <Amount>5.99</Amount> </RecoveryAmount> <OriginalAmount> <CurrencyCode>USD</CurrencyCode> <Amount>4.99</Amount> </OriginalAmount> <GroupBeginDate>2013-09-09T01:30:00.000-06:00</GroupBeginDate> <GroupEndDate>2013-09-23T01:30:00.000-06:00</GroupEndDate> </DebtRecoveryItem> </DebtRecoveryItemList> <ChargeInstrumentList> <ChargeInstrument> <Description>Credit card</Description> <Tail>9887</Tail> <Amount> <CurrencyCode>USD</CurrencyCode> <Amount>9.99</Amount> </Amount> </ChargeInstrument> </ChargeInstrumentList> </DebtRecoveryEvent> </DebtRecoveryEventList> <LoanServicingEventList> <LoanServicingEvent> <LoanAmount> <CurrencyCode>USD</CurrencyCode> <Amount>13.99</Amount> </LoanAmount> <SourceBusinessEventType>LoanAdvance</SourceBusinessEventType> </LoanServicingEvent> </LoanServicingEventList> <AdjustmentEventList> <AdjustmentEvent> <AdjustmentType>PostageBilling</AdjustmentType> <AdjustmentAmount> <CurrencyCode>USD</CurrencyCode> <Amount>-5.99</Amount> </AdjustmentAmount> <AdjustmentItemList> <AdjustmentItem> <Quantity>2</Quantity> <PerUnitAmount> <CurrencyCode>USD</CurrencyCode> <Amount>-1.99</Amount> </PerUnitAmount> <TotalAmount> <CurrencyCode>USD</CurrencyCode> <Amount>-5.99</Amount> </TotalAmount> <SellerSKU>ASK_AS_1</SellerSKU> <FNSKU>ASLKLDS12</FNSKU> <ProductDescription>Test Product</ProductDescription> <ASIN>BT0093TELA</ASIN> </AdjustmentItem> </AdjustmentItemList> </AdjustmentEvent> </AdjustmentEventList> </FinancialEvents> </ListFinancialEventsResult> <ResponseMetadata> <RequestId>1105b931-6f1c-4480-8e97-f3b46EXAMPLE</RequestId> </ResponseMetadata> </ListFinancialEventsResponse>