ListFinancialEvents

Returns financial events for a given order, financial event group, or date range.

Description

The ListFinancialEvents operation returns a list of financial events that matches the filter specified in the request.

You can filter by financial event group ID, date range, or order ID. If you specify a financial event group ID in the request, then all financial events in that financial event group are returned. If you specify a time range in the request, then all financial events that are posted between the time ranges are returned. If you specify an order ID in the request, then all financial events that are part of the order are returned.

Throttling

This operation has a maximum request quota of 30 and a restore rate of one request every two seconds. For definitions of throttling terminology and for a complete explanation of throttling, see 限制：针对提交请求频率的限制 in the 亚马逊MWS开发者指南.

Request parameters

For more information about the request parameters that are required for all 亚马逊MWS operations, see 必需的请求参数 in the 亚马逊MWS开发者指南.

Name	Description	Required	Valid values
MaxResultsPerPage	The maximum number of results to return per page.	No	Minimum: 1 Maximum: 100 Default: 100 类型：xs:int
AmazonOrderId	The identifier of the order for which you want to obtain all financial events.	You can only specify one of the following filter criteria: AmazonOrderId FinancialEventGroupId PostedAfter and optionally PostedBefore	Any valid Amazon order identifier in 3-7-7 format. 类型：xs:string
FinancialEventGroupId	The identifier of the financial event group for which you want to obtain all financial events.	You can only specify one of the following filter criteria: AmazonOrderId FinancialEventGroupId PostedAfter and optionally PostedBefore	Any valid financial event group identifier. 类型：xs:string
PostedAfter	A date used for selecting financial events posted after (or at) a specified time.	You can only specify one of the following filter criteria: AmazonOrderId FinancialEventGroupId PostedAfter and optionally PostedBefore	Any valid date no later than two minutes before the request was submitted, in ISO 8601 format. 类型：xs:dateTime
PostedBefore	A date used for selecting financial events posted before (but not at) a specified time.	You can only specify one of the following filter criteria: AmazonOrderId FinancialEventGroupId PostedAfter and optionally PostedBefore	Any valid date later than PostedAfter and no later than two minutes before the request was submitted, in ISO 8601 format. You must specify the PostedAfter request parameter if you specify this request parameter. Default: Now minus two minutes 类型：xs:dateTime

Response elements

Name	Description
NextToken	A generated string used to pass information to your next request. If NextToken is returned, pass the value of NextToken to ListFinancialEventsByNextToken. If NextToken is not returned, there are no more financial events to return. Optional 类型：xs:string
FinancialEvents	Contains the financial events that meet the criteria specified in the request. Type: FinancialEvents

Name

Description

NextToken

A generated string used to pass information to your next request. If NextToken is returned, pass the value of NextToken to ListFinancialEventsByNextToken. If NextToken is not returned, there are no more financial events to return.

Optional

类型：xs:string

FinancialEvents

Contains the financial events that meet the criteria specified in the request.

Type: FinancialEvents

Examples

Example query request

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

Example response

<?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>

Deprecation Notice:

ListFinancialEvents

Description

Throttling

Request parameters

Response elements

Examples

Example query request

Example response

Related topics