peddler 4.3.1 → 4.5.0

data/lib/peddler/api.rb

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
 require "http"
+require "uri"
 
 require "peddler/endpoint"
-require "peddler/error"
 require "peddler/marketplace"
 require "peddler/response"
 require "peddler/version"
@@ -78,8 +78,6 @@ module Peddler
     def meter(requests_per_second)
       return self if retries.zero?
 
-      # HTTP v6.0 will implement retriable. Until then, point to their GitHub repo, or it's a no-op.
-      # https://github.com/httprb/http/pull/790
       delay = sandbox? ? 0.2 : 1.0 / requests_per_second
       retriable(delay:, tries: retries + 1, retry_statuses: [429])
 
@@ -106,7 +104,7 @@ module Peddler
     #   @return [self]
     [:via, :use, :retriable].each do |method|
       define_method(method) do |*args, **kwargs, &block|
-        @http = http.send(method, *args, **kwargs, &block) if http.respond_to?(method)
+        @http = http.send(method, *args, **kwargs, &block)
         self
       end
     end
@@ -123,13 +121,7 @@ module Peddler
         end
 
         response = http.send(method, uri, **options)
-
-        if response.status.client_error?
-          error = Error.build(response)
-          raise error if error
-        end
-
-        Response.decorate(response, parser:)
+        Response.wrap(response, parser:)
       end
     end
 
@@ -158,5 +150,15 @@ module Peddler
     def timestamp
       Time.now.utc.strftime("%Y%m%dT%H%M%SZ")
     end
+
+    # Encodes URL path components
+    def percent_encode(component)
+      URI.encode_uri_component(component)
+    end
+
+    # Converts an array to a comma-separated string, or returns the value as-is if not an array
+    def stringify_array(val)
+      val.is_a?(Array) ? val.join(",") : val
+    end
   end
 end

data/lib/peddler/apis/amazon_warehousing_and_distribution_2024_05_09.rb

@@ -35,7 +35,7 @@ module Peddler
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def get_inbound(order_id, rate_limit: 2.0)
-        path = "/awd/2024-05-09/inboundOrders/#{order_id}"
+        path = "/awd/2024-05-09/inboundOrders/#{percent_encode(order_id)}"
 
         meter(rate_limit).get(path)
       end
@@ -49,7 +49,7 @@ module Peddler
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def update_inbound(order_id, body, rate_limit: 1.0)
-        path = "/awd/2024-05-09/inboundOrders/#{order_id}"
+        path = "/awd/2024-05-09/inboundOrders/#{percent_encode(order_id)}"
 
         meter(rate_limit).put(path, body:)
       end
@@ -61,7 +61,7 @@ module Peddler
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def cancel_inbound(order_id, rate_limit: 1.0)
-        path = "/awd/2024-05-09/inboundOrders/#{order_id}/cancellation"
+        path = "/awd/2024-05-09/inboundOrders/#{percent_encode(order_id)}/cancellation"
 
         meter(rate_limit).post(path)
       end
@@ -73,7 +73,7 @@ module Peddler
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def confirm_inbound(order_id, rate_limit: 1.0)
-        path = "/awd/2024-05-09/inboundOrders/#{order_id}/confirmation"
+        path = "/awd/2024-05-09/inboundOrders/#{percent_encode(order_id)}/confirmation"
 
         meter(rate_limit).post(path)
       end
@@ -87,7 +87,7 @@ module Peddler
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def get_inbound_shipment(shipment_id, sku_quantities: nil, rate_limit: 2.0)
-        path = "/awd/2024-05-09/inboundShipments/#{shipment_id}"
+        path = "/awd/2024-05-09/inboundShipments/#{percent_encode(shipment_id)}"
         params = {
           "skuQuantities" => sku_quantities,
         }.compact
@@ -106,7 +106,7 @@ module Peddler
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def get_inbound_shipment_labels(shipment_id, page_type: nil, format_type: nil, rate_limit: 1.0)
-        path = "/awd/2024-05-09/inboundShipments/#{shipment_id}/labels"
+        path = "/awd/2024-05-09/inboundShipments/#{percent_encode(shipment_id)}/labels"
         params = {
           "pageType" => page_type,
           "formatType" => format_type,
@@ -123,7 +123,7 @@ module Peddler
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def update_inbound_shipment_transport_details(shipment_id, body, rate_limit: 1.0)
-        path = "/awd/2024-05-09/inboundShipments/#{shipment_id}/transport"
+        path = "/awd/2024-05-09/inboundShipments/#{percent_encode(shipment_id)}/transport"
 
         meter(rate_limit).put(path, body:)
       end

data/lib/peddler/apis/aplus_content_2020_11_01.rb

@@ -72,10 +72,10 @@ module Peddler
       def get_content_document(content_reference_key, marketplace_id, included_data_set, rate_limit: 10.0)
         cannot_sandbox!
 
-        path = "/aplus/2020-11-01/contentDocuments/#{content_reference_key}"
+        path = "/aplus/2020-11-01/contentDocuments/#{percent_encode(content_reference_key)}"
         params = {
           "marketplaceId" => marketplace_id,
-          "includedDataSet" => included_data_set,
+          "includedDataSet" => stringify_array(included_data_set),
         }.compact
 
         meter(rate_limit).get(path, params:)
@@ -96,7 +96,7 @@ module Peddler
         rate_limit: 10.0)
         cannot_sandbox!
 
-        path = "/aplus/2020-11-01/contentDocuments/#{content_reference_key}"
+        path = "/aplus/2020-11-01/contentDocuments/#{percent_encode(content_reference_key)}"
         body = post_content_document_request
         params = {
           "marketplaceId" => marketplace_id,
@@ -125,11 +125,11 @@ module Peddler
         asin_set: nil, page_token: nil, rate_limit: 10.0)
         cannot_sandbox!
 
-        path = "/aplus/2020-11-01/contentDocuments/#{content_reference_key}/asins"
+        path = "/aplus/2020-11-01/contentDocuments/#{percent_encode(content_reference_key)}/asins"
         params = {
           "marketplaceId" => marketplace_id,
-          "includedDataSet" => included_data_set,
-          "asinSet" => asin_set,
+          "includedDataSet" => stringify_array(included_data_set),
+          "asinSet" => stringify_array(asin_set),
           "pageToken" => page_token,
         }.compact
 
@@ -154,7 +154,7 @@ module Peddler
         post_content_document_asin_relations_request, rate_limit: 10.0)
         cannot_sandbox!
 
-        path = "/aplus/2020-11-01/contentDocuments/#{content_reference_key}/asins"
+        path = "/aplus/2020-11-01/contentDocuments/#{percent_encode(content_reference_key)}/asins"
         body = post_content_document_asin_relations_request
         params = {
           "marketplaceId" => marketplace_id,
@@ -180,7 +180,7 @@ module Peddler
         body = post_content_document_request
         params = {
           "marketplaceId" => marketplace_id,
-          "asinSet" => asin_set,
+          "asinSet" => stringify_array(asin_set),
         }.compact
 
         meter(rate_limit).post(path, body:, params:)
@@ -223,7 +223,7 @@ module Peddler
       def post_content_document_approval_submission(content_reference_key, marketplace_id, rate_limit: 10.0)
         cannot_sandbox!
 
-        path = "/aplus/2020-11-01/contentDocuments/#{content_reference_key}/approvalSubmissions"
+        path = "/aplus/2020-11-01/contentDocuments/#{percent_encode(content_reference_key)}/approvalSubmissions"
         params = {
           "marketplaceId" => marketplace_id,
         }.compact
@@ -244,7 +244,7 @@ module Peddler
       def post_content_document_suspend_submission(content_reference_key, marketplace_id, rate_limit: 10.0)
         cannot_sandbox!
 
-        path = "/aplus/2020-11-01/contentDocuments/#{content_reference_key}/suspendSubmissions"
+        path = "/aplus/2020-11-01/contentDocuments/#{percent_encode(content_reference_key)}/suspendSubmissions"
         params = {
           "marketplaceId" => marketplace_id,
         }.compact

data/lib/peddler/apis/application_integrations_2024_04_01.rb

@@ -47,7 +47,7 @@ module Peddler
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def record_action_feedback(notification_id, body, rate_limit: 1.0)
-        path = "/appIntegrations/2024-04-01/notifications/#{notification_id}/feedback"
+        path = "/appIntegrations/2024-04-01/notifications/#{percent_encode(notification_id)}/feedback"
 
         meter(rate_limit).post(path, body:)
       end

data/lib/peddler/apis/catalog_items_2020_12_01.rb

@@ -40,11 +40,11 @@ module Peddler
         classification_ids: nil, page_size: 10, page_token: nil, keywords_locale: nil, locale: nil, rate_limit: 2.0)
         path = "/catalog/2020-12-01/items"
         params = {
-          "keywords" => keywords,
-          "marketplaceIds" => marketplace_ids,
-          "includedData" => included_data,
-          "brandNames" => brand_names,
-          "classificationIds" => classification_ids,
+          "keywords" => stringify_array(keywords),
+          "marketplaceIds" => stringify_array(marketplace_ids),
+          "includedData" => stringify_array(included_data),
+          "brandNames" => stringify_array(brand_names),
+          "classificationIds" => stringify_array(classification_ids),
           "pageSize" => page_size,
           "pageToken" => page_token,
           "keywordsLocale" => keywords_locale,
@@ -67,10 +67,10 @@ module Peddler
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def get_catalog_item(asin, marketplace_ids, included_data: "summaries", locale: nil, rate_limit: 2.0)
-        path = "/catalog/2020-12-01/items/#{asin}"
+        path = "/catalog/2020-12-01/items/#{percent_encode(asin)}"
         params = {
-          "marketplaceIds" => marketplace_ids,
-          "includedData" => included_data,
+          "marketplaceIds" => stringify_array(marketplace_ids),
+          "includedData" => stringify_array(included_data),
           "locale" => locale,
         }.compact
 

data/lib/peddler/apis/catalog_items_2022_04_01.rb

@@ -50,15 +50,15 @@ module Peddler
         page_token: nil, keywords_locale: nil, rate_limit: 5.0)
         path = "/catalog/2022-04-01/items"
         params = {
-          "identifiers" => identifiers,
+          "identifiers" => stringify_array(identifiers),
           "identifiersType" => identifiers_type,
-          "marketplaceIds" => marketplace_ids,
-          "includedData" => included_data,
+          "marketplaceIds" => stringify_array(marketplace_ids),
+          "includedData" => stringify_array(included_data),
           "locale" => locale,
           "sellerId" => seller_id,
-          "keywords" => keywords,
-          "brandNames" => brand_names,
-          "classificationIds" => classification_ids,
+          "keywords" => stringify_array(keywords),
+          "brandNames" => stringify_array(brand_names),
+          "classificationIds" => stringify_array(classification_ids),
           "pageSize" => page_size,
           "pageToken" => page_token,
           "keywordsLocale" => keywords_locale,
@@ -80,10 +80,10 @@ module Peddler
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def get_catalog_item(asin, marketplace_ids, included_data: ["summaries"], locale: nil, rate_limit: 5.0)
-        path = "/catalog/2022-04-01/items/#{asin}"
+        path = "/catalog/2022-04-01/items/#{percent_encode(asin)}"
         params = {
-          "marketplaceIds" => marketplace_ids,
-          "includedData" => included_data,
+          "marketplaceIds" => stringify_array(marketplace_ids),
+          "includedData" => stringify_array(included_data),
           "locale" => locale,
         }.compact
 

data/lib/peddler/apis/customer_feedback_2024_06_01.rb

@@ -0,0 +1,143 @@
+# frozen_string_literal: true
+
+require "peddler/api"
+
+module Peddler
+  class << self
+    def customer_feedback_2024_06_01(...)
+      APIs::CustomerFeedback20240601.new(...)
+    end
+  end
+
+  module APIs
+    # The Selling Partner API for CustomerFeedback
+    #
+    # The Selling Partner API for Customer Feedback (Customer Feedback API) provides information about customer reviews
+    # and returns at both the item and browse node level.
+    class CustomerFeedback20240601 < API
+      # Retrieve an item's ten most positive and ten most negative review topics.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param asin [String] The Amazon Standard Identification Number (ASIN) is the unique identifier of a product
+      #   within a marketplace. The value must be a child ASIN.
+      # @param marketplace_id [String] The MarketplaceId is the globally unique identifier of a marketplace, you can
+      #   refer to the marketplaceId here : https://developer-docs.amazon.com/sp-api/docs/marketplace-ids.
+      # @param sort_by [String] The metric by which to sort data in the response.
+      # @return [Peddler::Response] The API response
+      def get_item_review_topics(asin, marketplace_id, sort_by)
+        path = "/customerFeedback/2024-06-01/items/#{percent_encode(asin)}/reviews/topics"
+        params = {
+          "marketplaceId" => marketplace_id,
+          "sortBy" => sort_by,
+        }.compact
+
+        get(path, params:)
+      end
+
+      # This API returns the associated browse node of the requested ASIN. A browse node is a location in a browse tree
+      # that is used for navigation, product classification, and website content on the Amazon retail website.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param asin [String] The Amazon Standard Identification Number (ASIN) is the unique identifier of a product
+      #   within a marketplace.
+      # @param marketplace_id [String] The MarketplaceId is the globally unique identifier of a marketplace, you can
+      #   refer to the marketplaceId here : https://developer-docs.amazon.com/sp-api/docs/marketplace-ids.
+      # @return [Peddler::Response] The API response
+      def get_item_browse_node(asin, marketplace_id)
+        path = "/customerFeedback/2024-06-01/items/#{percent_encode(asin)}/browseNode"
+        params = {
+          "marketplaceId" => marketplace_id,
+        }.compact
+
+        get(path, params:)
+      end
+
+      # Retrieve a browse node's ten most positive and ten most negative review topics.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param browse_node_id [String] The ID of a browse node. A browse node is a named location in a browse tree that
+      #   is used for navigation, product classification, and website content.
+      # @param marketplace_id [String] The MarketplaceId is the globally unique identifier of a marketplace, you can
+      #   refer to the marketplaceId here : https://developer-docs.amazon.com/sp-api/docs/marketplace-ids.
+      # @param sort_by [String] The metric by which to sort the data in the response.
+      # @return [Peddler::Response] The API response
+      def get_browse_node_review_topics(browse_node_id, marketplace_id, sort_by)
+        path = "/customerFeedback/2024-06-01/browseNodes/#{percent_encode(browse_node_id)}/reviews/topics"
+        params = {
+          "marketplaceId" => marketplace_id,
+          "sortBy" => sort_by,
+        }.compact
+
+        get(path, params:)
+      end
+
+      # Retrieve an item's positive and negative review trends for the past six months.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param asin [String] The Amazon Standard Identification Number (ASIN) is the unique identifier of a product
+      #   within a marketplace. This API takes child ASIN as an input.
+      # @param marketplace_id [String] The MarketplaceId is the globally unique identifier of a marketplace, you can
+      #   refer to the marketplaceId here : https://developer-docs.amazon.com/sp-api/docs/marketplace-ids.
+      # @return [Peddler::Response] The API response
+      def get_item_review_trends(asin, marketplace_id)
+        path = "/customerFeedback/2024-06-01/items/#{percent_encode(asin)}/reviews/trends"
+        params = {
+          "marketplaceId" => marketplace_id,
+        }.compact
+
+        get(path, params:)
+      end
+
+      # Retrieve the positive and negative review trends of items in a browse node for the past six months.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param browse_node_id [String] A browse node ID is a unique identifier of a browse node. A browse node is a
+      #   named location in a browse tree that is used for navigation, product classification, and website content.
+      # @param marketplace_id [String] The marketplace ID is the globally unique identifier of a marketplace. For more
+      #   information, refer to [Marketplace IDs](https://developer-docs.amazon.com/sp-api/docs/marketplace-ids).
+      # @return [Peddler::Response] The API response
+      def get_browse_node_review_trends(browse_node_id, marketplace_id)
+        path = "/customerFeedback/2024-06-01/browseNodes/#{percent_encode(browse_node_id)}/reviews/trends"
+        params = {
+          "marketplaceId" => marketplace_id,
+        }.compact
+
+        get(path, params:)
+      end
+
+      # Retrieve the topics that customers mention when they return items in a browse node.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param browse_node_id [String] A browse node ID is a unique identifier for a browse node. A browse node is a
+      #   named location in a browse tree that is used for navigation, product classification, and website content.
+      # @param marketplace_id [String] The MarketplaceId is the globally unique identifier of a marketplace, you can
+      #   refer to the marketplaceId here : https://developer-docs.amazon.com/sp-api/docs/marketplace-ids.
+      # @return [Peddler::Response] The API response
+      def get_browse_node_return_topics(browse_node_id, marketplace_id)
+        path = "/customerFeedback/2024-06-01/browseNodes/#{percent_encode(browse_node_id)}/returns/topics"
+        params = {
+          "marketplaceId" => marketplace_id,
+        }.compact
+
+        get(path, params:)
+      end
+
+      # Retrieve the trends of topics that customers mention when they return items in a browse node.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param browse_node_id [String] A browse node ID is a unique identifier of a browse node. A browse node is a
+      #   named location in a browse tree that is used for navigation, product classification, and website content.
+      # @param marketplace_id [String] The MarketplaceId is the globally unique identifier of a marketplace, you can
+      #   refer to the marketplaceId here : https://developer-docs.amazon.com/sp-api/docs/marketplace-ids.
+      # @return [Peddler::Response] The API response
+      def get_browse_node_return_trends(browse_node_id, marketplace_id)
+        path = "/customerFeedback/2024-06-01/browseNodes/#{percent_encode(browse_node_id)}/returns/trends"
+        params = {
+          "marketplaceId" => marketplace_id,
+        }.compact
+
+        get(path, params:)
+      end
+    end
+  end
+end

data/lib/peddler/apis/data_kiosk_2023_11_15.rb

@@ -36,7 +36,7 @@ module Peddler
         pagination_token: nil, rate_limit: 0.0222)
         path = "/dataKiosk/2023-11-15/queries"
         params = {
-          "processingStatuses" => processing_statuses,
+          "processingStatuses" => stringify_array(processing_statuses),
           "pageSize" => page_size,
           "createdSince" => created_since,
           "createdUntil" => created_until,
@@ -73,7 +73,7 @@ module Peddler
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def cancel_query(query_id, rate_limit: 0.0222)
-        path = "/dataKiosk/2023-11-15/queries/#{query_id}"
+        path = "/dataKiosk/2023-11-15/queries/#{percent_encode(query_id)}"
 
         meter(rate_limit).delete(path)
       end
@@ -86,7 +86,7 @@ module Peddler
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def get_query(query_id, rate_limit: 2.0)
-        path = "/dataKiosk/2023-11-15/queries/#{query_id}"
+        path = "/dataKiosk/2023-11-15/queries/#{percent_encode(query_id)}"
 
         meter(rate_limit).get(path)
       end
@@ -99,7 +99,7 @@ module Peddler
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def get_document(document_id, rate_limit: 0.0167)
-        path = "/dataKiosk/2023-11-15/documents/#{document_id}"
+        path = "/dataKiosk/2023-11-15/documents/#{percent_encode(document_id)}"
 
         meter(rate_limit).get(path)
       end

data/lib/peddler/apis/fba_inbound_eligibility_v1.rb

@@ -32,7 +32,7 @@ module Peddler
       def get_item_eligibility_preview(asin, program, marketplace_ids: nil, rate_limit: 1.0)
         path = "/fba/inbound/v1/eligibility/itemPreview"
         params = {
-          "marketplaceIds" => marketplace_ids,
+          "marketplaceIds" => stringify_array(marketplace_ids),
           "asin" => asin,
           "program" => program,
         }.compact

data/lib/peddler/apis/fba_inventory_v1.rb

@@ -53,10 +53,10 @@ module Peddler
           "granularityType" => granularity_type,
           "granularityId" => granularity_id,
           "startDateTime" => start_date_time,
-          "sellerSkus" => seller_skus,
+          "sellerSkus" => stringify_array(seller_skus),
           "sellerSku" => seller_sku,
           "nextToken" => next_token,
-          "marketplaceIds" => marketplace_ids,
+          "marketplaceIds" => stringify_array(marketplace_ids),
         }.compact
 
         meter(rate_limit).get(path, params:)
@@ -89,7 +89,7 @@ module Peddler
       def delete_inventory_item(seller_sku, marketplace_id)
         must_sandbox!
 
-        path = "/fba/inventory/v1/items/#{seller_sku}"
+        path = "/fba/inventory/v1/items/#{percent_encode(seller_sku)}"
         params = {
           "marketplaceId" => marketplace_id,
         }.compact

data/lib/peddler/apis/feeds_2021_06_30.rb

@@ -41,10 +41,10 @@ module Peddler
         created_until: nil, next_token: nil, rate_limit: 0.0222)
         path = "/feeds/2021-06-30/feeds"
         params = {
-          "feedTypes" => feed_types,
-          "marketplaceIds" => marketplace_ids,
+          "feedTypes" => stringify_array(feed_types),
+          "marketplaceIds" => stringify_array(marketplace_ids),
           "pageSize" => page_size,
-          "processingStatuses" => processing_statuses,
+          "processingStatuses" => stringify_array(processing_statuses),
           "createdSince" => created_since,
           "createdUntil" => created_until,
           "nextToken" => next_token,
@@ -76,7 +76,7 @@ module Peddler
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def cancel_feed(feed_id, rate_limit: 2.0)
-        path = "/feeds/2021-06-30/feeds/#{feed_id}"
+        path = "/feeds/2021-06-30/feeds/#{percent_encode(feed_id)}"
 
         meter(rate_limit).delete(path)
       end
@@ -89,7 +89,7 @@ module Peddler
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def get_feed(feed_id, rate_limit: 2.0)
-        path = "/feeds/2021-06-30/feeds/#{feed_id}"
+        path = "/feeds/2021-06-30/feeds/#{percent_encode(feed_id)}"
 
         meter(rate_limit).get(path)
       end
@@ -116,7 +116,7 @@ module Peddler
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def get_feed_document(feed_document_id, rate_limit: 0.0222)
-        path = "/feeds/2021-06-30/documents/#{feed_document_id}"
+        path = "/feeds/2021-06-30/documents/#{percent_encode(feed_document_id)}"
 
         meter(rate_limit).get(path)
       end

data/lib/peddler/apis/finances_2024_06_01.rb

@@ -43,7 +43,7 @@ module Peddler
         path = "/finances/transfers/2024-06-01/paymentMethods"
         params = {
           "marketplaceId" => marketplace_id,
-          "paymentMethodTypes" => payment_method_types,
+          "paymentMethodTypes" => stringify_array(payment_method_types),
         }.compact
 
         meter(rate_limit).get(path, params:)

data/lib/peddler/apis/finances_2024_06_19.rb

@@ -16,27 +16,35 @@ module Peddler
     # can obtain financial events for a given order or date range without having to wait until a statement period
     # closes.
     class Finances20240619 < API
-      # Returns transactions for the given parameters. It may take up to 48 hours for transactions to appear in your
-      # transaction events.
+      # Returns transactions for the given parameters. Financial events might not include orders from the last 48 hours.
       #
       # @note This operation can make a static sandbox call.
-      # @param posted_after [String] A date used for selecting transactions 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 date time format.
+      # @param posted_after [String] The response includes financial events posted on or after this date. This date must
+      #   be in [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) date-time format. The date-time must
+      #   be more than two minutes before the time of the request.
       # @param posted_before [String] A date used for selecting transactions 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 date time format. If PostedAfter and PostedBefore are more than 180 days apart, no
       #   transactions are returned. You must specify the PostedAfter parameter if you specify the PostedBefore
       #   parameter. Default: Now minus two minutes.
-      # @param marketplace_id [String] A string token used to select Marketplace ID.
+      # @param marketplace_id [String] The identifier of the marketplace from which you want to retrieve transactions.
+      #   The marketplace ID is the globally unique identifier of a marketplace. To find the ID for your marketplace,
+      #   refer to [Marketplace IDs](https://developer-docs.amazon.com/sp-api/docs/marketplace-ids).
+      # @param transaction_status [String] The status of the transaction. **Possible values:** * `DEFERRED`: the
+      #   transaction is currently deferred. * `RELEASED`: the transaction is currently released. * `DEFERRED_RELEASED`:
+      #   the transaction was deferred in the past, but is now released. The status of a deferred transaction is updated
+      #   to `DEFERRED_RELEASED` when the transaction is released.
       # @param next_token [String] A string token returned in the response of your previous request.
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
-      def list_transactions(posted_after, posted_before: nil, marketplace_id: nil, next_token: nil, rate_limit: 0.5)
+      def list_transactions(posted_after, posted_before: nil, marketplace_id: nil, transaction_status: nil,
+        next_token: nil, rate_limit: 0.5)
         path = "/finances/2024-06-19/transactions"
         params = {
           "postedAfter" => posted_after,
           "postedBefore" => posted_before,
           "marketplaceId" => marketplace_id,
+          "transactionStatus" => transaction_status,
           "nextToken" => next_token,
         }.compact
 

data/lib/peddler/apis/finances_v0.rb

@@ -69,7 +69,7 @@ module Peddler
       # @return [Peddler::Response] The API response
       def list_financial_events_by_group_id(event_group_id, max_results_per_page: 100, posted_after: nil,
         posted_before: nil, next_token: nil, rate_limit: 0.5)
-        path = "/finances/v0/financialEventGroups/#{event_group_id}/financialEvents"
+        path = "/finances/v0/financialEventGroups/#{percent_encode(event_group_id)}/financialEvents"
         params = {
           "MaxResultsPerPage" => max_results_per_page,
           "PostedAfter" => posted_after,
@@ -91,7 +91,7 @@ module Peddler
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def list_financial_events_by_order_id(order_id, max_results_per_page: 100, next_token: nil, rate_limit: 0.5)
-        path = "/finances/v0/orders/#{order_id}/financialEvents"
+        path = "/finances/v0/orders/#{percent_encode(order_id)}/financialEvents"
         params = {
           "MaxResultsPerPage" => max_results_per_page,
           "NextToken" => next_token,