peddler 2.4.5 → 3.0.0.beta1

data/lib/peddler/api/data_kiosk_2023_11_15.rb

@@ -0,0 +1,92 @@
+# frozen_string_literal: true
+
+require "peddler/api"
+
+module Peddler
+  class API
+    # Selling Partner API for Data Kiosk
+    #
+    # The Selling Partner API for Data Kiosk lets you submit GraphQL queries from a variety of schemas to help selling
+    # partners manage their businesses.
+    class DataKiosk20231115 < API
+      # Returns details for the Data Kiosk queries that match the specified filters. See the `createQuery` operation for
+      # details about query retention.
+      #
+      # @param [Array<String>] processing_statuses A list of processing statuses used to filter queries.
+      # @param [Integer] page_size The maximum number of queries to return in a single call.
+      # @param [String] created_since The earliest query creation date and time for queries to include in the response,
+      #   in ISO 8601 date time format. The default is 90 days ago.
+      # @param [String] created_until The latest query creation date and time for queries to include in the response, in
+      #   ISO 8601 date time format. The default is the time of the `getQueries` request.
+      # @param [String] pagination_token A token to fetch a certain page of results when there are multiple pages of
+      #   results available. The value of this token is fetched from the `pagination.nextToken` field returned in the
+      #   `GetQueriesResponse` object. All other parameters must be provided with the same values that were provided
+      #   with the request that generated this token, with the exception of `pageSize` which can be modified between
+      #   calls to `getQueries`. In the absence of this token value, `getQueries` returns the first page of results.
+      # @return [Hash] The API response
+      def get_queries(processing_statuses: nil, page_size: nil, created_since: nil, created_until: nil,
+        pagination_token: nil)
+        path = "/dataKiosk/2023-11-15/queries"
+        params = {
+          "processingStatuses" => processing_statuses,
+          "pageSize" => page_size,
+          "createdSince" => created_since,
+          "createdUntil" => created_until,
+          "paginationToken" => pagination_token,
+        }.compact
+
+        rate_limit(0.0222).get(path, params:)
+      end
+
+      # Creates a Data Kiosk query request.
+      # @note The retention of a query varies based on the fields requested. Each field within a schema is annotated
+      #   with a `@resultRetention` directive that defines how long a query containing that field will be retained. When
+      #   a query contains multiple fields with different retentions, the shortest (minimum) retention is applied. The
+      #   retention of a query's resulting documents always matches the retention of the query.
+      #
+      # @param [Hash] body The body of the request.
+      # @return [Hash] The API response
+      def create_query(body)
+        path = "/dataKiosk/2023-11-15/queries"
+
+        rate_limit(0.0167).post(path, body:)
+      end
+
+      # Cancels the query specified by the `queryId` parameter. Only queries with a non-terminal `processingStatus`
+      # (`IN_QUEUE`, `IN_PROGRESS`) can be cancelled. Cancelling a query that already has a `processingStatus` of
+      # `CANCELLED` will no-op. Cancelled queries are returned in subsequent calls to the `getQuery` and `getQueries`
+      # operations.
+      #
+      # @param [String] query_id The identifier for the query. This identifier is unique only in combination with a
+      #   selling partner account ID.
+      # @return [Hash] The API response
+      def cancel_query(query_id)
+        path = "/dataKiosk/2023-11-15/queries/#{query_id}"
+
+        rate_limit(0.0222).delete(path)
+      end
+
+      # Returns query details for the query specified by the `queryId` parameter. See the `createQuery` operation for
+      # details about query retention.
+      #
+      # @param [String] query_id The query identifier.
+      # @return [Hash] The API response
+      def get_query(query_id)
+        path = "/dataKiosk/2023-11-15/queries/#{query_id}"
+
+        rate_limit(2.0).get(path)
+      end
+
+      # Returns the information required for retrieving a Data Kiosk document's contents. See the `createQuery`
+      # operation for details about document retention.
+      #
+      # @param [String] document_id The identifier for the Data Kiosk document.
+      # @return [Hash] The API response
+      def get_document(document_id)
+        path = "/dataKiosk/2023-11-15/documents/#{document_id}"
+
+        rate_limit(0.0167).get(path)
+      end
+    end
+  end
+end

data/lib/peddler/api/easy_ship_2022_03_23.rb

@@ -0,0 +1,108 @@
+# frozen_string_literal: true
+
+require "peddler/api"
+
+module Peddler
+  class API
+    # Selling Partner API for Easy Ship
+    #
+    # The Selling Partner API for Easy Ship helps you build applications that help sellers manage and ship Amazon Easy
+    # Ship orders. Your Easy Ship applications can: * Get available time slots for packages to be scheduled for
+    # delivery. * Schedule, reschedule, and cancel Easy Ship orders. * Print labels, invoices, and warranties. See the
+    # [Marketplace Support Table](doc:easyship-api-v2022-03-23-use-case-guide#marketplace-support-table) for the
+    # differences in Easy Ship operations by marketplace.
+    class EasyShip20220323 < API
+      # Returns time slots available for Easy Ship orders to be scheduled based on the package weight and dimensions
+      # that the seller specifies. This operation is available for scheduled and unscheduled orders based on marketplace
+      # support. See **Get Time Slots** in the [Marketplace Support
+      # Table](doc:easyship-api-v2022-03-23-use-case-guide#marketplace-support-table). This operation can return time
+      # slots that have either pickup or drop-off handover methods - see **Supported Handover Methods** in the
+      # [Marketplace Support Table](doc:easyship-api-v2022-03-23-use-case-guide#marketplace-support-table).
+      #
+      # @param [Hash] list_handover_slots_request The request schema for the `listHandoverSlots` operation.
+      # @return [Hash] The API response
+      def list_handover_slots(list_handover_slots_request: nil)
+        path = "/easyShip/2022-03-23/timeSlot"
+        body = list_handover_slots_request
+
+        rate_limit(1.0).post(path, body:)
+      end
+
+      # Returns information about a package, including dimensions, weight, time slot information for handover, invoice
+      # and item information, and status.
+      #
+      # @param [String] amazon_order_id An Amazon-defined order identifier. Identifies the order that the seller wants
+      #   to deliver using Amazon Easy Ship.
+      # @param [String] marketplace_id An identifier for the marketplace in which the seller is selling.
+      # @return [Hash] The API response
+      def get_scheduled_package(amazon_order_id, marketplace_id)
+        path = "/easyShip/2022-03-23/package"
+        params = {
+          "amazonOrderId" => amazon_order_id,
+          "marketplaceId" => marketplace_id,
+        }.compact
+
+        rate_limit(1.0).get(path, params:)
+      end
+
+      # Schedules an Easy Ship order and returns the scheduled package information. This operation does the following: *
+      # Specifies the time slot and handover method for the order to be scheduled for delivery. * Updates the Easy Ship
+      # order status. * Generates a shipping label and an invoice. Calling `createScheduledPackage` also generates a
+      # warranty document if you specify a `SerialNumber` value. To get these documents, see [How to get invoice,
+      # shipping label, and warranty documents](doc:easyship-api-v2022-03-23-use-case-guide). * Shows the status of Easy
+      # Ship orders when you call the `getOrders` operation of the Selling Partner API for Orders and examine the
+      # `EasyShipShipmentStatus` property in the response body. See the **Shipping Label**, **Invoice**, and
+      # **Warranty** columns in the [Marketplace Support
+      # Table](doc:easyship-api-v2022-03-23-use-case-guide#marketplace-support-table) to see which documents are
+      # supported in each marketplace.
+      #
+      # @param [Hash] create_scheduled_package_request The request schema for the `createScheduledPackage` operation.
+      # @return [Hash] The API response
+      def create_scheduled_package(create_scheduled_package_request)
+        path = "/easyShip/2022-03-23/package"
+        body = create_scheduled_package_request
+
+        rate_limit(1.0).post(path, body:)
+      end
+
+      # Updates the time slot for handing over the package indicated by the specified `scheduledPackageId`. You can get
+      # the new `slotId` value for the time slot by calling the `listHandoverSlots` operation before making another
+      # `patch` call. See the **Update Package** column in the [Marketplace Support
+      # Table](doc:easyship-api-v2022-03-23-use-case-guide#marketplace-support-table) to see which marketplaces this
+      # operation is supported in.
+      #
+      # @param [Hash] update_scheduled_packages_request The request schema for the `updateScheduledPackages` operation.
+      # @return [Hash] The API response
+      def update_scheduled_packages(update_scheduled_packages_request: nil)
+        path = "/easyShip/2022-03-23/package"
+        body = update_scheduled_packages_request
+
+        rate_limit(1.0).patch(path, body:)
+      end
+
+      # This operation automatically schedules a time slot for all the `amazonOrderId`s given as input, generating the
+      # associated shipping labels, along with other compliance documents according to the marketplace (refer to the
+      # [marketplace document support table](doc:easyship-api-v2022-03-23-use-case-guide#marketplace-support-table)).
+      # Developers calling this operation may optionally assign a `packageDetails` object, allowing them to input a
+      # preferred time slot for each order in ther request. In this case, Amazon will try to schedule the respective
+      # packages using their optional settings. On the other hand, *i.e.*, if the time slot is not provided, Amazon will
+      # then pick the earliest time slot possible. Regarding the shipping label's file format, external developers are
+      # able to choose between PDF or ZPL, and Amazon will create the label accordingly. This operation returns an array
+      # composed of the scheduled packages, and a short-lived URL pointing to a zip file containing the generated
+      # shipping labels and the other documents enabled for your marketplace. If at least an order couldn't be
+      # scheduled, then Amazon adds the `rejectedOrders` list into the response, which contains an entry for each order
+      # we couldn't process. Each entry is composed of an error message describing the reason of the failure, so that
+      # sellers can take action. The table below displays the supported request and burst maximum rates:
+      #
+      # @param [Hash] create_scheduled_packages_request The request schema for the `createScheduledPackageBulk`
+      #   operation.
+      # @return [Hash] The API response
+      def create_scheduled_package_bulk(create_scheduled_packages_request)
+        path = "/easyShip/2022-03-23/packages/bulk"
+        body = create_scheduled_packages_request
+
+        rate_limit(1.0).post(path, body:)
+      end
+    end
+  end
+end

data/lib/peddler/api/fba_inbound_eligibility_v1.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+require "peddler/api"
+
+module Peddler
+  class API
+    # Selling Partner API for FBA Inbound Eligibilty
+    #
+    # With the FBA Inbound Eligibility API, you can build applications that let sellers get eligibility previews for
+    # items before shipping them to Amazon's fulfillment centers. With this API you can find out if an item is eligible
+    # for inbound shipment to Amazon's fulfillment centers in a specific marketplace. You can also find out if an item
+    # is eligible for using the manufacturer barcode for FBA inventory tracking. Sellers can use this information to
+    # inform their decisions about which items to ship Amazon's fulfillment centers.
+    class FBAInboundEligibilityV1 < API
+      # This operation gets an eligibility preview for an item that you specify. You can specify the type of eligibility
+      # preview that you want (INBOUND or COMMINGLING). For INBOUND previews, you can specify the marketplace in which
+      # you want to determine the item's eligibility.
+      #
+      # @param [Array<String>] marketplace_ids The identifier for the marketplace in which you want to determine
+      #   eligibility. Required only when program=INBOUND.
+      # @param [String] asin The ASIN of the item for which you want an eligibility preview.
+      # @param [String] program The program that you want to check eligibility against.
+      # @return [Hash] The API response
+      def get_item_eligibility_preview(asin, program, marketplace_ids: nil)
+        path = "/fba/inbound/v1/eligibility/itemPreview"
+        params = {
+          "marketplaceIds" => marketplace_ids,
+          "asin" => asin,
+          "program" => program,
+        }.compact
+
+        rate_limit(1.0).get(path, params:)
+      end
+    end
+  end
+end

data/lib/peddler/api/fba_inventory_v1.rb

@@ -0,0 +1,106 @@
+# frozen_string_literal: true
+
+require "peddler/api"
+
+module Peddler
+  class API
+    # Selling Partner API for FBA Inventory
+    #
+    # The Selling Partner API for FBA Inventory lets you programmatically retrieve information about inventory in
+    # Amazon's fulfillment network.
+    class FBAInventoryV1 < API
+      # Returns a list of inventory summaries. The summaries returned depend on the presence or absence of the
+      # startDateTime, sellerSkus and sellerSku parameters: - All inventory summaries with available details are
+      # returned when the startDateTime, sellerSkus and sellerSku parameters are omitted. - When startDateTime is
+      # provided, the operation returns inventory summaries that have had changes after the date and time specified. The
+      # sellerSkus and sellerSku parameters are ignored. Important: To avoid errors, use both startDateTime and
+      # nextToken to get the next page of inventory summaries that have changed after the date and time specified. -
+      # When the sellerSkus parameter is provided, the operation returns inventory summaries for only the specified
+      # sellerSkus. The sellerSku parameter is ignored. - When the sellerSku parameter is provided, the operation
+      # returns inventory summaries for only the specified sellerSku. Note: The parameters associated with this
+      # operation may contain special characters that must be encoded to successfully call the API. To avoid errors with
+      # SKUs when encoding URLs, refer to URL Encoding. Usage Plan: | Rate (requests per second) | Burst | | ---- | ----
+      # | | 2 | 2 | The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to
+      # the requested operation, when available. The table above indicates the default rate and burst values for this
+      # operation. Selling partners whose business demands require higher throughput may see higher rate and burst
+      # values than those shown here. For more information, see Usage Plans and Rate Limits in the Selling Partner API.
+      #
+      # @param [Boolean] details true to return inventory summaries with additional summarized inventory details and
+      #   quantities. Otherwise, returns inventory summaries only (default value).
+      # @param [String] granularity_type The granularity type for the inventory aggregation level.
+      # @param [String] granularity_id The granularity ID for the inventory aggregation level.
+      # @param [String] start_date_time A start date and time in ISO8601 format. If specified, all inventory summaries
+      #   that have changed since then are returned. You must specify a date and time that is no earlier than 18 months
+      #   prior to the date and time when you call the API. Note: Changes in inboundWorkingQuantity,
+      #   inboundShippedQuantity and inboundReceivingQuantity are not detected.
+      # @param [Array<String>] seller_skus A list of seller SKUs for which to return inventory summaries. You may
+      #   specify up to 50 SKUs.
+      # @param [String] seller_sku A single seller SKU used for querying the specified seller SKU inventory summaries.
+      # @param [String] next_token String token returned in the response of your previous request. The string token will
+      #   expire 30 seconds after being created.
+      # @param [Array<String>] marketplace_ids The marketplace ID for the marketplace for which to return inventory
+      #   summaries.
+      # @return [Hash] The API response
+      def get_inventory_summaries(granularity_type, granularity_id, marketplace_ids, details: nil,
+        start_date_time: nil, seller_skus: nil, seller_sku: nil, next_token: nil)
+        path = "/fba/inventory/v1/summaries"
+        params = {
+          "details" => details,
+          "granularityType" => granularity_type,
+          "granularityId" => granularity_id,
+          "startDateTime" => start_date_time,
+          "sellerSkus" => seller_skus,
+          "sellerSku" => seller_sku,
+          "nextToken" => next_token,
+          "marketplaceIds" => marketplace_ids,
+        }.compact
+
+        rate_limit(2.0).get(path, params:)
+      end
+
+      # Requests that Amazon create product-details in the Sandbox Inventory in the sandbox environment. This is a
+      # sandbox-only operation and must be directed to a sandbox endpoint. Refer to [Selling Partner API
+      # sandbox](https://developer-docs.amazon.com/sp-api/docs/the-selling-partner-api-sandbox) for more information.
+      #
+      # @param [Hash] create_inventory_item_request_body CreateInventoryItem Request Body Parameter.
+      # @return [Hash] The API response
+      def create_inventory_item(create_inventory_item_request_body)
+        path = "/fba/inventory/v1/items"
+        body = create_inventory_item_request_body
+
+        post(path, body:)
+      end
+
+      # Requests that Amazon Deletes an item from the Sandbox Inventory in the sandbox environment. This is a
+      # sandbox-only operation and must be directed to a sandbox endpoint. Refer to [Selling Partner API
+      # sandbox](https://developer-docs.amazon.com/sp-api/docs/the-selling-partner-api-sandbox) for more information.
+      #
+      # @param [String] seller_sku A single seller SKU used for querying the specified seller SKU inventory summaries.
+      # @param [String] marketplace_id The marketplace ID for the marketplace for which the sellerSku is to be deleted.
+      # @return [Hash] The API response
+      def delete_inventory_item(seller_sku, marketplace_id)
+        path = "/fba/inventory/v1/items/#{seller_sku}"
+        params = {
+          "marketplaceId" => marketplace_id,
+        }.compact
+
+        delete(path, params:)
+      end
+
+      # Requests that Amazon add items to the Sandbox Inventory with desired amount of quantity in the sandbox
+      # environment. This is a sandbox-only operation and must be directed to a sandbox endpoint. Refer to [Selling
+      # Partner API sandbox](https://developer-docs.amazon.com/sp-api/docs/the-selling-partner-api-sandbox) for more
+      # information.
+      #
+      # @param [String] x_amzn_idempotency_token A unique token/requestId provided with each call to ensure idempotency.
+      # @param [Hash] add_inventory_request_body List of items to add to Sandbox inventory.
+      # @return [Hash] The API response
+      def add_inventory(x_amzn_idempotency_token, add_inventory_request_body)
+        path = "/fba/inventory/v1/items/inventory"
+        body = add_inventory_request_body
+
+        post(path, body:)
+      end
+    end
+  end
+end

data/lib/peddler/api/feeds_2021_06_30.rb

@@ -0,0 +1,104 @@
+# frozen_string_literal: true
+
+require "peddler/api"
+
+module Peddler
+  class API
+    # Selling Partner API for Feeds
+    #
+    # The Selling Partner API for Feeds lets you upload data to Amazon on behalf of a selling partner.
+    class Feeds20210630 < API
+      # Returns feed details for the feeds that match the filters that you specify.
+      #
+      # @param [Array<String>] feed_types A list of feed types used to filter feeds. When feedTypes is provided, the
+      #   other filter parameters (processingStatuses, marketplaceIds, createdSince, createdUntil) and pageSize may also
+      #   be provided. Either feedTypes or nextToken is required.
+      # @param [Array<String>] marketplace_ids A list of marketplace identifiers used to filter feeds. The feeds
+      #   returned will match at least one of the marketplaces that you specify.
+      # @param [Integer] page_size The maximum number of feeds to return in a single call.
+      # @param [Array<String>] processing_statuses A list of processing statuses used to filter feeds.
+      # @param [String] created_since The earliest feed creation date and time for feeds included in the response, in
+      #   ISO 8601 format. The default is 90 days ago. Feeds are retained for a maximum of 90 days.
+      # @param [String] created_until The latest feed creation date and time for feeds included in the response, in ISO
+      #   8601 format. The default is now.
+      # @param [String] next_token A string token returned in the response to your previous request. nextToken is
+      #   returned when the number of results exceeds the specified pageSize value. To get the next page of results,
+      #   call the getFeeds operation and include this token as the only parameter. Specifying nextToken with any other
+      #   parameters will cause the request to fail.
+      # @return [Hash] The API response
+      def get_feeds(feed_types: nil, marketplace_ids: nil, page_size: nil, processing_statuses: nil,
+        created_since: nil, created_until: nil, next_token: nil)
+        path = "/feeds/2021-06-30/feeds"
+        params = {
+          "feedTypes" => feed_types,
+          "marketplaceIds" => marketplace_ids,
+          "pageSize" => page_size,
+          "processingStatuses" => processing_statuses,
+          "createdSince" => created_since,
+          "createdUntil" => created_until,
+          "nextToken" => next_token,
+        }.compact
+
+        rate_limit(0.0222).get(path, params:)
+      end
+
+      # Creates a feed. Upload the contents of the feed document before calling this operation.
+      #
+      # @param [Hash] body Information required to create the feed.
+      # @return [Hash] The API response
+      def create_feed(body)
+        path = "/feeds/2021-06-30/feeds"
+
+        rate_limit(0.0083).post(path, body:)
+      end
+
+      # Cancels the feed that you specify. Only feeds with `processingStatus=IN_QUEUE` can be cancelled. Cancelled feeds
+      # are returned in subsequent calls to the
+      # [`getFeed`](https://developer-docs.amazon.com/sp-api/docs/feeds-api-v2021-06-30-reference#getfeed) and
+      # [`getFeeds`](https://developer-docs.amazon.com/sp-api/docs/feeds-api-v2021-06-30-reference#getfeeds) operations.
+      #
+      # @param [String] feed_id The identifier for the feed. This identifier is unique only in combination with a seller
+      #   ID.
+      # @return [Hash] The API response
+      def cancel_feed(feed_id)
+        path = "/feeds/2021-06-30/feeds/#{feed_id}"
+
+        rate_limit(2.0).delete(path)
+      end
+
+      # Returns feed details (including the `resultDocumentId`, if available) for the feed that you specify.
+      #
+      # @param [String] feed_id The identifier for the feed. This identifier is unique only in combination with a seller
+      #   ID.
+      # @return [Hash] The API response
+      def get_feed(feed_id)
+        path = "/feeds/2021-06-30/feeds/#{feed_id}"
+
+        rate_limit(2.0).get(path)
+      end
+
+      # Creates a feed document for the feed type that you specify. This operation returns a presigned URL for uploading
+      # the feed document contents. It also returns a `feedDocumentId` value that you can pass in with a subsequent call
+      # to the [`createFeed`](https://developer-docs.amazon.com/sp-api/docs/feeds-api-v2021-06-30-reference#createfeed)
+      # operation.
+      #
+      # @param [Hash] body Specifies the content type for the createFeedDocument operation.
+      # @return [Hash] The API response
+      def create_feed_document(body)
+        path = "/feeds/2021-06-30/documents"
+
+        rate_limit(0.5).post(path, body:)
+      end
+
+      # Returns the information required for retrieving a feed document's contents.
+      #
+      # @param [String] feed_document_id The identifier of the feed document.
+      # @return [Hash] The API response
+      def get_feed_document(feed_document_id)
+        path = "/feeds/2021-06-30/documents/#{feed_document_id}"
+
+        rate_limit(0.0222).get(path)
+      end
+    end
+  end
+end

data/lib/peddler/api/finances_v0.rb

@@ -0,0 +1,121 @@
+# frozen_string_literal: true
+
+require "peddler/api"
+
+module Peddler
+  class API
+    # Selling Partner API for Finances
+    #
+    # The Selling Partner API for Finances helps you obtain financial information relevant to a seller's business. You
+    # can obtain financial events for a given order, financial event group, or date range without having to wait until a
+    # statement period closes. You can also obtain financial event groups for a given date range.
+    class FinancesV0 < API
+      # Returns financial event groups for a given date range. It may take up to 48 hours for orders to appear in your
+      # financial events.
+      #
+      # @param [Integer] max_results_per_page The maximum number of results to return per page. If the response exceeds
+      #   the maximum number of transactions or 10 MB, the API responds with 'InvalidInput'.
+      # @param [String] financial_event_group_started_before A date used for selecting financial event groups that
+      #   opened before (but not at) a specified date and time, in [ISO
+      #   8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) format. The date-time must be later than
+      #   FinancialEventGroupStartedAfter and no later than two minutes before the request was submitted. If
+      #   FinancialEventGroupStartedAfter and FinancialEventGroupStartedBefore are more than 180 days apart, no
+      #   financial event groups are returned.
+      # @param [String] financial_event_group_started_after A date used for selecting financial event groups that opened
+      #   after (or at) a specified date and time, in [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601)
+      #   format. The date-time must be no later than two minutes before the request was submitted.
+      # @param [String] next_token A string token returned in the response of your previous request.
+      # @return [Hash] The API response
+      def list_financial_event_groups(max_results_per_page: nil, financial_event_group_started_before: nil,
+        financial_event_group_started_after: nil, next_token: nil)
+        path = "/finances/v0/financialEventGroups"
+        params = {
+          "MaxResultsPerPage" => max_results_per_page,
+          "FinancialEventGroupStartedBefore" => financial_event_group_started_before,
+          "FinancialEventGroupStartedAfter" => financial_event_group_started_after,
+          "NextToken" => next_token,
+        }.compact
+
+        rate_limit(0.5).get(path, params:)
+      end
+
+      # Returns all financial events for the specified financial event group. It may take up to 48 hours for orders to
+      # appear in your financial events.
+      # @note This operation will only retrieve group's data for the past two years. If a request is submitted for data
+      #   spanning more than two years, an empty response is returned.
+      #
+      # @param [Integer] max_results_per_page The maximum number of results to return per page. If the response exceeds
+      #   the maximum number of transactions or 10 MB, the API responds with 'InvalidInput'.
+      # @param [String] posted_after A date used for selecting financial events posted after (or at) a specified time.
+      #   The date-time **must** be more than two minutes before the time of the request, in [ISO
+      #   8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) date time format.
+      # @param [String] posted_before A date used for selecting financial events posted before (but not at) a specified
+      #   time. The date-time must be later than `PostedAfter` and no later than two minutes before the request was
+      #   submitted, in [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) date time format. If
+      #   `PostedAfter` and `PostedBefore` are more than 180 days apart, no financial events are returned. You must
+      #   specify the `PostedAfter` parameter if you specify the `PostedBefore` parameter. Default: Now minus two
+      #   minutes.
+      # @param [String] event_group_id The identifier of the financial event group to which the events belong.
+      # @param [String] next_token A string token returned in the response of your previous request.
+      # @return [Hash] The API response
+      def list_financial_events_by_group_id(event_group_id, max_results_per_page: nil, posted_after: nil,
+        posted_before: nil, next_token: nil)
+        path = "/finances/v0/financialEventGroups/#{event_group_id}/financialEvents"
+        params = {
+          "MaxResultsPerPage" => max_results_per_page,
+          "PostedAfter" => posted_after,
+          "PostedBefore" => posted_before,
+          "NextToken" => next_token,
+        }.compact
+
+        rate_limit(0.5).get(path, params:)
+      end
+
+      # Returns all financial events for the specified order. It may take up to 48 hours for orders to appear in your
+      # financial events.
+      #
+      # @param [String] order_id An Amazon-defined order identifier, in 3-7-7 format.
+      # @param [Integer] max_results_per_page The maximum number of results to return per page. If the response exceeds
+      #   the maximum number of transactions or 10 MB, the API responds with 'InvalidInput'.
+      # @param [String] next_token A string token returned in the response of your previous request.
+      # @return [Hash] The API response
+      def list_financial_events_by_order_id(order_id, max_results_per_page: nil, next_token: nil)
+        path = "/finances/v0/orders/#{order_id}/financialEvents"
+        params = {
+          "MaxResultsPerPage" => max_results_per_page,
+          "NextToken" => next_token,
+        }.compact
+
+        rate_limit(0.5).get(path, params:)
+      end
+
+      # Returns financial events for the specified data range. It may take up to 48 hours for orders to appear in your
+      # financial events.
+      # @note in `ListFinancialEvents`, deferred events don't show up in responses until in they are released.
+      #
+      # @param [Integer] max_results_per_page The maximum number of results to return per page. If the response exceeds
+      #   the maximum number of transactions or 10 MB, the API responds with 'InvalidInput'.
+      # @param [String] posted_after A date used for selecting financial events posted after (or at) a specified time.
+      #   The date-time must be no later than two minutes before the request was submitted, in [ISO
+      #   8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) date time format.
+      # @param [String] posted_before A date used for selecting financial events posted before (but not at) a specified
+      #   time. The date-time must be later than PostedAfter and no later than two minutes before the request was
+      #   submitted, in [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) date time format. If
+      #   PostedAfter and PostedBefore are more than 180 days apart, no financial events are returned. You must specify
+      #   the PostedAfter parameter if you specify the PostedBefore parameter. Default: Now minus two minutes.
+      # @param [String] next_token A string token returned in the response of your previous request.
+      # @return [Hash] The API response
+      def list_financial_events(max_results_per_page: nil, posted_after: nil, posted_before: nil, next_token: nil)
+        path = "/finances/v0/financialEvents"
+        params = {
+          "MaxResultsPerPage" => max_results_per_page,
+          "PostedAfter" => posted_after,
+          "PostedBefore" => posted_before,
+          "NextToken" => next_token,
+        }.compact
+
+        rate_limit(0.5).get(path, params:)
+      end
+    end
+  end
+end