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

ListFinancialEvents

指定した注文、ファイナンスイベントグループ、または期間のファイナンスイベントを返します。

説明

ListFinancialEventsオペレーションは、リクエストで指定されたフィルターに一致するファイナンスイベントのリストを返します。

ファイナンスイベントグループID、期間、注文番号でフィルターできます。リクエストでファイナンスイベントグループIDを指定すると、そのファイナンスイベントグループに含まれるすべてのファイナンスイベントが返されます。リクエストで時間の範囲を指定すると、その期間にポストされたすべてのファイナンスイベントが返されます。リクエストで注文番号を指定すると、その注文に含まれるすべてのファイナンスイベントが返されます。

利用可否

このオペレーションはすべてのマーケットプレイスで利用できます。

スロットリング

このオペレーションの最大リクエストクォータは30回で、回復レートは2秒につき1リクエストです。スロットリング用語の定義およびスロットルの詳しい説明については、Amazon MWS開発者ガイドスロットリング:リクエストの送信頻度を制限するを参照してください。

リクエストパラメーター

すべてのAmazon MWSオペレーションで必須のリクエストパラメーターについては、Amazon MWS開発者ガイド必須のリクエストパラメーターを参照してください。

名前 説明 必須 有効値
MaxResultsPerPage ページあたりの返される結果の最大数。 いいえ 最小:1

最大:100

デフォルト:100

タイプ:xs:int

AmazonOrderId 注文番号。指定すると該当するすべてのファイナンスイベントを返します。 次のフィルター条件のうち1つのみを指定できます。
  • AmazonOrderId
  • FinancialEventGroupId
  • PostedAfterおよびオプションでPostedBefore
Amazonの有効な注文番号(3桁-7桁-7桁の形式)。

タイプ:xs:string

FinancialEventGroupId ファイナンスイベントグループID。指定すると該当するすべてのファイナンスイベントを返します。 次のフィルター条件のうち1つのみを指定できます。
  • AmazonOrderId
  • FinancialEventGroupId
  • PostedAfterおよびオプションでPostedBefore
ファイナンスイベントグループの有効なID。

タイプ:xs:string

PostedAfter ある時刻以降にポストされたファイナンスイベントを選択するために指定する日時。 次のフィルター条件のうち1つのみを指定できます。
  • AmazonOrderId
  • FinancialEventGroupId
  • PostedAfterおよびオプションでPostedBefore
リクエストの送信時刻の2分前より前の有効な日時(ISO 8601日時フォーマット形式)。

タイプ:xs:dateTime

PostedBefore ある時刻より前(その時刻は含まない)にポストされたファイナンスイベントを選択するために指定する日時。 次のフィルター条件のうち1つのみを指定できます。
  • AmazonOrderId
  • FinancialEventGroupId
  • PostedAfterおよびオプションでPostedBefore
PostedAfterより後で、リクエストの送信時刻の2分前より前の有効な日時(ISO 8601日時フォーマット形式)。PostedAfterPostedBeforeの間隔が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>

↑ トップへ戻る