Amazon Services
Amazon Marketplace Web Service (Amazon MWS) Documentation

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 Documentation

ListFinancialEventsByNextToken

Returns the next page of financial events using the NextToken parameter.

Description

The ListFinancialEventsByNextToken operation returns the next page of financial events using the NextToken value that was returned by your previous request to either ListFinancialEvents or ListFinancialEventsByNextToken. If NextToken is not returned, there are no more pages to return.

Events posted more than 18 months before the current date are not returned.

Availability

This operation is available in all marketplaces.

Throttling

Maximum request quota Restore rate Hourly request quota
30 requests One request every two seconds 1800 requests per hour
For definitions of throttling terminology and for a complete explanation of throttling, see Throttling: Limits to how often you can submit requests in the Amazon MWS Developer Guide.

Request parameters

For more information about the request parameters that are required for all Amazon MWS operations, see Required request parameters in the Amazon MWS Developer Guide.

Name Description Required Valid values
NextToken A string token returned in the response of your previous request to either ListFinancialEvents or ListFinancialEventsByNextToken. Yes Type: xs:string

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

Type: xs:string

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

Type: FinancialEvents

Examples

Example query request

For information about standard request requirements, see Required request parameters.

Show example code Hide example code

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=ListFinancialEventsByNextToken
&MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE
&NextToken=88faca76-b600-46d2-b53c-0c8c4EXAMPLE
&SellerId=A1XEXAMPLEDF
&SignatureMethod=HmacSHA256
&SignatureVersion=2
&Timestamp=2015-05-01T18%3A12%3A21.687Z
&Version=2015-05-01
&Signature=ZQLpf8vEXAMPLE0iC265pf18n0%3D

↑ Top

Example response

For information about standard response formatting, see Response format.

Show example code Hide example code

<?xml version="1.0"?>
<ListFinancialEventsByNextTokenResponse xmlns="http://mws.amazonservices.com/Finances/2018-08-02">
  <ListFinancialEventsByNextTokenResult>
    <NextToken>e21hcmtldHBsYWNlSWQ6bnVsbCxtYXhSZXN1bHRzUGVyUGFnZTowLHNlYXJjaFF1ZXJ5Q2hlY2tzdW06bnVsbCxxdWVyeVBhZ2luYXRpb25Ub2tlbjoidDB3V25MNXFLWkRIZ2p5ZzB3ZHRWODVnV0htVExVMkM0XzlsMHpRMG9HVXFZOVhTdjFyWUNWUE8teGxWRnF3N0ZyaDIyY3lQX0VTOXYxendQNUVvc0t0V1NKM1YyQkRJdWcyWFpXdm1KVmdPVktBdzNIMXUyVHBiTGoxVmRmY3Z6ZlU1WlpNaEpsQ0RKUnYxRk16am13Y1YyQ1BoOXNWMU1xNUZqamxUMlRCeFBkSjdEa3BkbENISElVZ094aHVTN3ZfZlFCUWYyWWJYZ2l3NHNxZXkwNnQyaVBucm5PdnAzRTdKbW4xcnc1UTlaTGV1Ymk5WUV6UGJ6UnhjRmh2VUFKdlQ5U2U3eERIdHVMUzNJVWFRODBubVhja3JLeWt3dVZKeWZXQm5CY3p0bjZTbVRHenJmZ1VOanFMWFFNT2giLHNlYXJjaFF1ZXJ5Om51bGwsdG9rZW5DcmVhdGlvbkRhdGU6MTQ4NTg2MjY5ODI1NCxzZWxsZXJJZDoiQTM1SlMxREpITjdGViJ9</NextToken>
    <FinancialEvents>
      <ProductAdsPaymentEventList/>
      <RentalTransactionEventList/>
      <PayWithAmazonEventList/>
      <SellerDealPaymentEventList>
        <SellerDealPaymentEvent>
          <PostedDate>2016-11-21T16:18:15.000Z</PostedDate>
          <DealDescription>test fees</DealDescription>
          <DealId>fec11097c1f4379426a7de68bf938b684f677de2</DealId>
          <EventType>SellerDealComplete</EventType>
          <FeeType>RunLightningDealFee</FeeType>
          <FeeAmount>
            <CurrencyAmount>16.38</CurrencyAmount>
            <CurrencyCode>USD</CurrencyCode>
          </FeeAmount>
          <TaxAmount>
            <CurrencyAmount>3.18</CurrencyAmount>
            <CurrencyCode>USD</CurrencyCode>
          </TaxAmount>
        </SellerDealPaymentEvent>
      </SellerDealPaymentEventList>
      <ProductAdsPaymentEventList>
        <ProductAdsPaymentEvent>
          <PostedDate>2017-01-11T13:17:15.000Z</PostedDate>
          <transactionType>Charge</transactionType>
          <invoiceId>TR1W0B4YB-6</invoiceId>
          <baseValue>
            <CurrencyAmount>115.34</CurrencyAmount>
            <CurrencyCode>USD</CurrencyCode>
          </baseValue>
          <taxValue>
            <CurrencyAmount>21.91</CurrencyAmount>
            <CurrencyCode>USD</CurrencyCode>
          </taxValue>
          <transactionValue>
            <CurrencyAmount>137.25</CurrencyAmount>
            <CurrencyCode>USD</CurrencyCode>
          </transactionValue>
        </ProductAdsPaymentEvent>
      </ProductAdsPaymentEventList>
      <AffordabilityExpenseEventList>
        <AffordabilityExpenseEvent>
          <PostedDate>2018-02-08T13:17:15.000Z</PostedDate>
          <TransactionType>Charge</TransactionType>
          <AmazonOrderId>931-2463294-5740665</AmazonOrderId>
          <MarketplaceId>A2XZLSVIQ0F4JT</MarketplaceId>
          <BaseExpense>
            <CurrencyAmount>-100.00</CurrencyAmount>
            <CurrencyCode>INR</CurrencyCode>
          </BaseExpense>
          <TaxTypeIGST>
            <CurrencyAmount>-18.00</CurrencyAmount>
            <CurrencyCode>INR</CurrencyCode>
          </TaxTypeIGST>
          <TaxTypeSGST>
            <CurrencyAmount>0.00</CurrencyAmount>
            <CurrencyCode>INR</CurrencyCode>
          </TaxTypeSGST>
          <TaxTypeCGST>
            <CurrencyAmount>0.00</CurrencyAmount>
            <CurrencyCode>INR</CurrencyCode>
          </TaxTypeCGST>
          <TotalExpense>
            <CurrencyAmount>-118.00</CurrencyAmount>
            <CurrencyCode>INR</CurrencyCode>
          </TotalExpense>
        </AffordabilityExpenseEvent>
      </AffordabilityExpenseEventList>
      <ServiceFeeEventList>
        <ServiceFeeEvent>
          <FeeDescription>Shacke Luggage Tags with Full Back Privacy Cover w/ Steel Loops - Set of 2
            (Green)</FeeDescription>
          <SellerSKU>FH-REED-16DX</SellerSKU>
        </ServiceFeeEvent>
        <ServiceFeeEvent>
          <FeeDescription>Shacke Luggage Tags with Full Back Privacy Cover w/ Steel Loops - Set of 2
            (Green)</FeeDescription>
          <SellerSKU>FH-REED-16DX</SellerSKU>
          <FeeList>
            <FeeComponent>
              <FeeType>FBACustomerReturnPerOrderFee</FeeType>
              <FeeAmount>
                <CurrencyAmount>-1.0</CurrencyAmount>
                <CurrencyCode>USD</CurrencyCode>
              </FeeAmount>
            </FeeComponent>
            <FeeComponent>
              <FeeType>FBACustomerReturnPerUnitFee</FeeType>
              <FeeAmount>
                <CurrencyAmount>-1.06</CurrencyAmount>
                <CurrencyCode>USD</CurrencyCode>
              </FeeAmount>
            </FeeComponent>
            <FeeComponent>
              <FeeType>FBACustomerReturnWeightBasedFee</FeeType>
              <FeeAmount>
                <CurrencyAmount>-0.5</CurrencyAmount>
                <CurrencyCode>USD</CurrencyCode>
              </FeeAmount>
            </FeeComponent>
          </FeeList>
        </ServiceFeeEvent>
      </ServiceFeeEventList>
      <AffordabilityExpenseReversalEventList>
        <AffordabilityExpenseReversalEvent>
          <PostedDate>2018-02-08T13:17:15.000Z</PostedDate>
          <TransactionType>Refund</TransactionType>
          <AmazonOrderId>931-2463294-5740665</AmazonOrderId>
          <MarketplaceId>A2XZLSVIQ0F4JT</MarketplaceId>
          <BaseExpense>
            <CurrencyAmount>100.00</CurrencyAmount>
            <CurrencyCode>INR</CurrencyCode>
          </BaseExpense>
          <TaxTypeIGST>
            <CurrencyAmount>18.00</CurrencyAmount>
            <CurrencyCode>INR</CurrencyCode>
          </TaxTypeIGST>
          <TaxTypeSGST>
            <CurrencyAmount>0.00</CurrencyAmount>
            <CurrencyCode>INR</CurrencyCode>
          </TaxTypeSGST>
          <TaxTypeCGST>
            <CurrencyAmount>0.00</CurrencyAmount>
            <CurrencyCode>INR</CurrencyCode>
          </TaxTypeCGST>
          <TotalExpense>
            <CurrencyAmount>118.00</CurrencyAmount>
            <CurrencyCode>INR</CurrencyCode>
          </TotalExpense>
        </AffordabilityExpenseReversalEvent>
      </AffordabilityExpenseReversalEventList>
      <ServiceProviderCreditEventList/>
      <SellerDealPaymentEventList/>
      <DebtRecoveryEventList/>
      <AdjustmentEventList>
        <AdjustmentEvent>
          <AdjustmentItemList>
            <AdjustmentItem>
              <PerUnitAmount>
                <CurrencyAmount>3.38</CurrencyAmount>
                <CurrencyCode>USD</CurrencyCode>
              </PerUnitAmount>
              <TotalAmount>
                <CurrencyAmount>3.38</CurrencyAmount>
                <CurrencyCode>USD</CurrencyCode>
              </TotalAmount>
              <Quantity>1</Quantity>
              <SellerSKU>KL-BPYA-C1VH</SellerSKU>
              <ProductDescription>Shacke Metal Shoe Horn 7.5&quot; inches - Double Sided Stainless
                Steel (Silver)</ProductDescription>
            </AdjustmentItem>
          </AdjustmentItemList>
          <AdjustmentType>REVERSAL_REIMBURSEMENT</AdjustmentType>
        </AdjustmentEvent>
      </AdjustmentEventList>
      <PerformanceBondRefundEventList/>
    </FinancialEvents>
  </ListFinancialEventsByNextTokenResult>
  <ResponseMetadata>
    <RequestId>c07d1dd2-12f9-415f-a167-8ab5f7726dbf</RequestId>
  </ResponseMetadata>
</ListFinancialEventsByNextTokenResponse>

↑ Top