Amazon Selling Partner icon

Amazon Selling Partner

Interact with Amazon Selling Partner API

Actions26

Finance → List Transactions

AI-generated

Overview

This node operation interacts with the Amazon Selling Partner API to list financial transactions within a specified date range. It is useful for sellers or financial analysts who need to retrieve transaction data such as payments, refunds, or fees from their Amazon marketplace accounts. For example, a user can specify a date range to get all transactions posted after a certain date and before another, optionally filtering by marketplace ID and controlling pagination with options like max results per page and next token.

Use Case Examples

  1. Retrieve all financial transactions posted between January 1, 2024, and January 31, 2024, for a specific Amazon marketplace.
  2. Fetch transactions with pagination, limiting results to 50 per page and using a next token to continue from the previous query.

Properties

Name Meaning
Posted After A date used for selecting transactions posted on or after this specified date (ISO 8601 format). This is a required filter to define the start of the transaction date range.
Posted Before A date used for selecting transactions posted before (but not on) this specified date (ISO 8601 format). This defines the end of the transaction date range.
Marketplace ID The identifier of the Amazon marketplace for which transactions should be returned. This allows filtering transactions by marketplace.
Additional Options A collection of optional parameters to control the query behavior, including pagination and result limits.

Output

JSON

  • transactionId - Unique identifier of the financial transaction.
  • transactionType - Type of the transaction, e.g., payment, refund, fee.
  • postedDate - The date when the transaction was posted.
  • amount
    • currencyCode - Currency code of the transaction amount.
    • amount - Monetary value of the transaction.
  • marketplaceId - Identifier of the marketplace related to the transaction.
  • status - Current status of the transaction.

Dependencies

  • Amazon Selling Partner API credentials

Troubleshooting

  • Ensure the 'Posted After' date is provided and correctly formatted in ISO 8601 format, as it is required.
  • Check API credentials and permissions to access financial data from the Amazon Selling Partner API.
  • If pagination is used, verify that the 'Next Token' is correctly passed to retrieve subsequent pages.
  • Handle API rate limits and errors gracefully; the node throws errors with messages from the API if requests fail.

Links

Discussion