peddler 5.4.0 → 5.5.0

data/lib/peddler/apis/notifications_v1/send_test_notification_response.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+# This file is generated. Do not edit.
+
+require "structure"
+
+module Peddler
+  module APIs
+    class NotificationsV1
+      # The response schema for the `sendTestNotification` operation.
+      SendTestNotificationResponse = Structure.new do
+        # @return [Array<Error>] One or more unexpected errors occurred during the `sendTestNotification` operation.
+        attribute?(:errors, [Error])
+
+        # @return [String] The payload for the `sendTestNotification` operation.
+        attribute?(:payload, String)
+      end
+    end
+  end
+end

data/lib/peddler/apis/notifications_v1/test_notification.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+# This file is generated. Do not edit.
+
+require "structure"
+
+module Peddler
+  module APIs
+    class NotificationsV1
+      # The describer for the test notification that will be delivered.
+      TestNotification = Structure.new do
+        # @return [String] The version of the payload object to be used in the notification.
+        attribute(:payload_version, String, null: false, from: "payloadVersion")
+
+        # @return [String] The scenario of the specified notification to be used in the notification payload. If
+        #   testScenario is empty, a 400 response will be returned back to the developer. The scenarios supported for
+        #   each notification type can be found in the Selling Partner API Developer Guide.
+        attribute?(:test_scenario, String, from: "testScenario")
+      end
+    end
+  end
+end

data/lib/peddler/apis/notifications_v1.rb

@@ -16,14 +16,15 @@ module Peddler
     # @see https://github.com/amzn/selling-partner-api-models/blob/main/models/notifications-api-model/notifications.json
     class NotificationsV1 < API
       # Returns information about subscription of the specified notification type and payload version. `payloadVersion`
-      # is an optional parameter. When `payloadVersion` is not provided, it will return latest payload version
-      # subscription's information. You can use this API to get subscription information when you do not have a
+      # is an optional parameter. When you do not provide `payloadVersion`, the operation returns the latest payload
+      # version subscription's information. You can use this API to get subscription information when you do not have a
       # subscription identifier.
       #
       # @note This operation can make a static sandbox call.
-      # @param payload_version [String] The version of the payload object to be used in the notification.
       # @param notification_type [String] The type of notification. For more information about notification types, refer
-      #   to [Notification Type Values](https://developer-docs.amazon.com/sp-api/docs/notification-type-values).
+      #   to the [Notifications API v1 Use Case
+      #   Guide](https://developer-docs.amazon.com/sp-api/docs/notifications-api-v1-use-case-guide).
+      # @param payload_version [String] The version of the payload object to be used in the notification.
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def get_subscription(notification_type, payload_version: nil, rate_limit: 1.0)
@@ -36,14 +37,15 @@ module Peddler
       end
 
       # Creates a subscription for the specified notification type to be delivered to the specified destination. Before
-      # you can subscribe, you must first create the destination by calling the `createDestination` operation. In cases
-      # where the specified notification type supports multiple payload versions, you can utilize this API to subscribe
+      # you can subscribe, you must first create the destination by calling the `createDestination` operation. If the
+      # notification type that you specify supports multiple payload versions, you can use this operation to subscribe
       # to a different payload version if you already have an existing subscription for a different payload version.
       #
       # @note This operation can make a static sandbox call.
-      # @param body [Hash]
+      # @param body [Hash] The request schema for the `createSubscription` operation.
       # @param notification_type [String] The type of notification. For more information about notification types, refer
-      #   to [Notification Type Values](https://developer-docs.amazon.com/sp-api/docs/notification-type-values).
+      #   to the [Notifications API v1 Use Case
+      #   Guide](https://developer-docs.amazon.com/sp-api/docs/notifications-api-v1-use-case-guide).
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def create_subscription(body, notification_type, rate_limit: 1.0)
@@ -54,12 +56,14 @@ module Peddler
 
       # Returns information about a subscription for the specified notification type. The `getSubscriptionById`
       # operation is grantless. For more information, refer to [Grantless
-      # operations](https://developer-docs.amazon.com/sp-api/docs/grantless-operations).
+      # Operations](https://developer-docs.amazon.com/sp-api/docs/grantless-operations) in the Selling Partner API
+      # Developer Guide.
       #
       # @note This operation can make a static sandbox call.
       # @param subscription_id [String] The identifier for the subscription that you want to get.
       # @param notification_type [String] The type of notification. For more information about notification types, refer
-      #   to [Notification Type Values](https://developer-docs.amazon.com/sp-api/docs/notification-type-values).
+      #   to the [Notifications API v1 Use Case
+      #   Guide](https://developer-docs.amazon.com/sp-api/docs/notifications-api-v1-use-case-guide).
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def get_subscription_by_id(subscription_id, notification_type, rate_limit: 1.0)
@@ -72,12 +76,14 @@ module Peddler
       # subscription identifier can be for any subscription associated with your application. After you successfully
       # call this operation, notifications will stop being sent for the associated subscription. The
       # `deleteSubscriptionById` operation is grantless. For more information, refer to [Grantless
-      # operations](https://developer-docs.amazon.com/sp-api/docs/grantless-operations).
+      # Operations](https://developer-docs.amazon.com/sp-api/docs/grantless-operations) in the Selling Partner API
+      # Developer Guide.
       #
       # @note This operation can make a static sandbox call.
       # @param subscription_id [String] The identifier for the subscription that you want to delete.
       # @param notification_type [String] The type of notification. For more information about notification types, refer
-      #   to [Notification Type Values](https://developer-docs.amazon.com/sp-api/docs/notification-type-values).
+      #   to the [Notifications API v1 Use Case
+      #   Guide](https://developer-docs.amazon.com/sp-api/docs/notifications-api-v1-use-case-guide).
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def delete_subscription_by_id(subscription_id, notification_type, rate_limit: 1.0)
@@ -86,8 +92,27 @@ module Peddler
         delete(path, rate_limit:, parser:)
       end
 
+      # Sends a mock notification of the specified type to your SQS. The `sendTestNotification` API is grantless. For
+      # more information, see "Grantless operations" in the Selling Partner API Developer Guide.
+      #
+      # @note This operation can make a dynamic sandbox call.
+      # @param body [Hash] The request schema for the `sendTestNotification` operation.
+      # @param notification_type [String] The type of notification. For more information about notification types, refer
+      #   to the [Notifications API v1 Use Case
+      #   Guide](https://developer-docs.amazon.com/sp-api/docs/notifications-api-v1-use-case-guide).
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def send_test_notification(body, notification_type, rate_limit: 1.0)
+        must_sandbox!
+
+        path = "/notifications/v1/subscriptions/#{percent_encode(notification_type)}/testNotification"
+        parser = -> { SendTestNotificationResponse }
+        post(path, body:, rate_limit:, parser:)
+      end
+
       # Returns information about all destinations. The `getDestinations` operation is grantless. For more information,
-      # refer to [Grantless operations](https://developer-docs.amazon.com/sp-api/docs/grantless-operations).
+      # refer to [Grantless Operations](https://developer-docs.amazon.com/sp-api/docs/grantless-operations) in the
+      # Selling Partner API Developer Guide.
       #
       # @note This operation can make a static sandbox call.
       # @param rate_limit [Float] Requests per second
@@ -100,10 +125,11 @@ module Peddler
 
       # Creates a destination resource to receive notifications. The `createDestination` operation is grantless. For
       # more information, refer to [Grantless
-      # operations](https://developer-docs.amazon.com/sp-api/docs/grantless-operations).
+      # Operations](https://developer-docs.amazon.com/sp-api/docs/grantless-operations) in the Selling Partner API
+      # Developer Guide.
       #
       # @note This operation can make a static sandbox call.
-      # @param body [Hash]
+      # @param body [Hash] The request schema for the `createDestination` operation.
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def create_destination(body, rate_limit: 1.0)
@@ -114,7 +140,8 @@ module Peddler
 
       # Returns information about the destination that you specify. The `getDestination` operation is grantless. For
       # more information, refer to [Grantless
-      # operations](https://developer-docs.amazon.com/sp-api/docs/grantless-operations).
+      # Operations](https://developer-docs.amazon.com/sp-api/docs/grantless-operations) in the Selling Partner API
+      # Developer Guide.
       #
       # @note This operation can make a static sandbox call.
       # @param destination_id [String] The identifier generated when you created the destination.
@@ -127,7 +154,8 @@ module Peddler
       end
 
       # Deletes the destination that you specify. The `deleteDestination` operation is grantless. For more information,
-      # refer to [Grantless operations](https://developer-docs.amazon.com/sp-api/docs/grantless-operations).
+      # refer to [Grantless Operations](https://developer-docs.amazon.com/sp-api/docs/grantless-operations) in the
+      # Selling Partner API Developer Guide.
       #
       # @note This operation can make a static sandbox call.
       # @param destination_id [String] The identifier for the destination that you want to delete.

data/lib/peddler/apis/orders_2026_01_01/fulfillment_order.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+# This file is generated. Do not edit.
+
+require "structure"
+
+module Peddler
+  module APIs
+    class Orders20260101
+      # Information about a fulfillment order associated with a customer order. A fulfillment order represents a unit of
+      # fulfillment created by Amazon for the order. **Note:** Only available for EasyShip orders at present.
+      FulfillmentOrder = Structure.new do
+        # @return [String] The Fulfillment Order ID assigned by Amazon after fulfillment planning. This identifier is
+        #   identical to the Shipment ID required by External Fulfillment APIs.
+        attribute(:fulfillment_order_id, String, null: false, from: "fulfillmentOrderId")
+      end
+    end
+  end
+end

data/lib/peddler/apis/orders_2026_01_01/item_proceeds_breakdown.rb

@@ -9,16 +9,16 @@ module Peddler
     class Orders20260101
       # Detailed proceeds breakdown for a specific order item.
       ItemProceedsBreakdown = Structure.new do
-        # @return [Array<ItemProceedsDetailedBreakdown>] Further granular breakdown of the subtotal.
-        attribute?(:detailed_breakdowns, [ItemProceedsDetailedBreakdown], from: "detailedBreakdowns")
-
         # @return [Money] Monetary amount for the proceeds breakdown.
-        attribute?(:subtotal, Money)
+        attribute(:subtotal, Money, null: false)
 
         # @return [String] Category classification of the proceeds breakdown.
         #
         # **Possible values**: `ITEM`, `SHIPPING`, `GIFT_WRAP`, `COD_FEE`, `OTHER`, `TAX`, `DISCOUNT`
-        attribute?(:type, String)
+        attribute(:type, String, null: false)
+
+        # @return [Array<ItemProceedsDetailedBreakdown>] Further granular breakdown of the subtotal.
+        attribute?(:detailed_breakdowns, [ItemProceedsDetailedBreakdown], from: "detailedBreakdowns")
       end
     end
   end

data/lib/peddler/apis/orders_2026_01_01/order.rb

@@ -37,6 +37,11 @@ module Peddler
         # @return [OrderFulfillment] Information about how this order is being processed and shipped.
         attribute?(:fulfillment, OrderFulfillment)
 
+        # @return [Array<FulfillmentOrder>] The list of fulfillment orders associated with this customer order. Each
+        #   entry corresponds to one fulfillment unit created by Amazon for this order. **Note:** Only available for
+        #   EasyShip orders at present.
+        attribute?(:fulfillment_orders, [FulfillmentOrder], from: "fulfillmentOrders")
+
         # @return [Array<Alias>] Alternative identifiers that can be used to reference this order, such as
         #   seller-defined order numbers.
         attribute?(:order_aliases, [Alias], from: "orderAliases")

data/lib/peddler/apis/orders_2026_01_01/order_proceeds.rb

@@ -9,6 +9,11 @@ module Peddler
     class Orders20260101
       # The money that the seller receives from the sale of the order.
       OrderProceeds = Structure.new do
+        # @return [Array<OrderProceedsBreakdown>] Categorized proceeds for the order. Proceed categories are either
+        #   aggregated across all order items (such as `ITEM`, `SHIPPING`, and `TAX`) or applied at the order level
+        #   (such as `DELIVERY_TIP`).
+        attribute?(:breakdowns, [OrderProceedsBreakdown])
+
         # @return [Money] The total amount that the seller receives from the sale of the order.
         attribute?(:grand_total, Money, from: "grandTotal")
       end

data/lib/peddler/apis/orders_2026_01_01/order_proceeds_breakdown.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+# This file is generated. Do not edit.
+
+require "structure"
+
+module Peddler
+  module APIs
+    class Orders20260101
+      # An entry detailing proceeds information.
+      OrderProceedsBreakdown = Structure.new do
+        # @return [Money] The monetary amount for the proceeds category.
+        attribute(:subtotal, Money, null: false)
+
+        # @return [String] The proceeds category.
+        #
+        # **Possible values**: `ITEM`, `SHIPPING`, `GIFT_WRAP`, `COD_FEE`, `TAX`, `DISCOUNT`, `DELIVERY_TIP`, `OTHER`.
+        #   **Note:** `DELIVERY_TIP` is charged separately and not attributed to a specific item. The remaining
+        #   categories are aggregated across all order items.
+        attribute(:type, String, null: false)
+
+        # @return [String] The processing status of the charge. Only present for categories processed separately after
+        #   checkout, such as `DELIVERY_TIP`.
+        #
+        # **Possible values**: `PENDING`, `FINALIZED`.
+        attribute?(:status, String)
+      end
+    end
+  end
+end

data/lib/peddler/apis/orders_v0/approved_alternative_details.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+# This file is generated. Edit template if necessary.
+
+module Peddler
+  module APIs
+    class OrdersV0
+      # Pre-approved alternative product attributes available for a rejected order. Each element contains an attribute
+      # name, its original value from the rejected order, and the corrected value that would result in approval (for
+      # example, a substituted `asin` or adjusted `petWeight`).
+      class ApprovedAlternativeDetails < Array
+        class << self
+          def parse(array)
+            new(array.map { |item| ApprovedAttribute.parse(item) })
+          end
+        end
+      end
+    end
+  end
+end

data/lib/peddler/apis/orders_v0/approved_attribute.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+# This file is generated. Do not edit.
+
+require "structure"
+
+module Peddler
+  module APIs
+    class OrdersV0
+      # An order attribute with its original value and the pre-approved alternative value suggested by the vet.
+      ApprovedAttribute = Structure.new do
+        # @return [String] The pre-approved value that would result in order approval.
+        attribute(:approved_value, String, null: false, from: "approvedValue")
+
+        # @return [String] The name of the attribute requiring correction (for example, `asin`, `petWeight`).
+        attribute(:attribute_name, String, null: false, from: "attributeName")
+
+        # @return [String] The original value of the attribute in the rejected order.
+        attribute(:original_value, String, null: false, from: "originalValue")
+      end
+    end
+  end
+end

data/lib/peddler/apis/orders_v0/interim_status_detail.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+# This file is generated. Do not edit.
+
+require "structure"
+require "time"
+
+module Peddler
+  module APIs
+    class OrdersV0
+      # Interim status information provided during the verification process to share granular progress updates while an
+      # order is pending verification (for example, vet contacted through email).
+      InterimStatusDetail = Structure.new do
+        # @return [String] The identifier for the interim status type. Must be one of the `ValidInterimStatusCodes`
+        #   values returned by the `getOrderRegulatedInfo` operation.
+        attribute(:status_code, String, null: false, from: "statusCode")
+
+        # @return [Time] The date and time when this interim status was set, in [ISO
+        #   8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) date and time format.
+        attribute(:status_date_time, Time, null: false, from: "statusDateTime")
+      end
+    end
+  end
+end

data/lib/peddler/apis/orders_v0/regulated_order_verification_status.rb

@@ -31,6 +31,11 @@ module Peddler
         #   8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) date time format.
         attribute?(:review_date, String, from: "ReviewDate")
 
+        # @return [Array<ValidInterimStatusCode>] Valid interim status codes that may be used when populating
+        #   `InterimStatusDetail`. Each element contains a `StatusCode` identifier and its customer-facing
+        #   `StatusDescription`.
+        attribute?(:valid_interim_status_codes, [ValidInterimStatusCode], from: "ValidInterimStatusCodes")
+
         # @return [Array<ValidVerificationDetail>] A list of valid verification details that may be provided and the
         #   criteria required for when the verification detail can be provided.
         attribute?(:valid_verification_details, [ValidVerificationDetail], from: "ValidVerificationDetails")

data/lib/peddler/apis/orders_v0/valid_interim_status_code.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+# This file is generated. Do not edit.
+
+require "structure"
+
+module Peddler
+  module APIs
+    class OrdersV0
+      # A valid interim status code and its customer-facing description. Available with the `getOrderRegulatedInfo`
+      # operation to indicate which status codes can populate the `InterimStatusDetail` field.
+      ValidInterimStatusCode = Structure.new do
+        # @return [String] The identifier for the interim status type.
+        attribute(:status_code, String, null: false, from: "StatusCode")
+
+        # @return [String] A customer-facing description of the interim status.
+        attribute(:status_description, String, null: false, from: "StatusDescription")
+      end
+    end
+  end
+end

data/lib/peddler/apis/orders_v0/valid_verification_detail.rb

@@ -18,7 +18,8 @@ module Peddler
         attribute(:valid_verification_statuses, Array, null: false, from: "ValidVerificationStatuses")
 
         # @return [String] A supported type of verification detail. The type indicates which verification detail could
-        #   be shared while updating the regulated order. Valid value: `prescriptionDetail`.
+        #   be shared while updating the regulated order. Valid values: `prescriptionDetail`,
+        #   `approvedAlternativeDetails`, `interimStatusDetail`.
         attribute(:verification_detail_type, String, null: false, from: "VerificationDetailType")
       end
     end

data/lib/peddler/apis/orders_v0/verification_details.rb

@@ -9,6 +9,14 @@ module Peddler
     class OrdersV0
       # Additional information related to the verification of a regulated order.
       VerificationDetails = Structure.new do
+        # @return [Array<ApprovedAttribute>] Pre-approved alternative product attributes provided when a vet rejects an
+        #   order but suggests a correction. Only valid when the verification status is `Rejected`.
+        attribute?(:approved_alternative_details, [ApprovedAttribute], from: "approvedAlternativeDetails")
+
+        # @return [InterimStatusDetail] Interim status information provided during the verification process. Only valid
+        #   when the verification status is `Pending`.
+        attribute?(:interim_status_detail, InterimStatusDetail, from: "interimStatusDetail")
+
         # @return [PrescriptionDetail] Information regarding the prescription tied to the order.
         attribute?(:prescription_detail, PrescriptionDetail, from: "prescriptionDetail")
       end

data/lib/peddler/apis/product_type_definitions_2020_09_01/error_list.rb

@@ -9,7 +9,7 @@ module Peddler
     class ProductTypeDefinitions20200901
       # A list of error responses returned when a request is unsuccessful.
       ErrorList = Structure.new do
-        # @return [Array<Error>]
+        # @return [Array<Error>] A list of error responses.
         attribute(:errors, [Error], null: false)
       end
     end

data/lib/peddler/apis/product_type_definitions_2020_09_01/product_type.rb

@@ -9,7 +9,7 @@ module Peddler
     class ProductTypeDefinitions20200901
       # An Amazon product type with a definition available.
       ProductType = Structure.new do
-        # @return [String] The human-readable and localized description of the Amazon product type.
+        # @return [String] Human-readable and localized description of the Amazon product type.
         attribute(:display_name, String, null: false, from: "displayName")
 
         # @return [Array<String>] The Amazon marketplace identifiers for which the product type definition is available.

data/lib/peddler/apis/product_type_definitions_2020_09_01/product_type_list.rb

@@ -12,7 +12,7 @@ module Peddler
         # @return [String] Amazon product type version identifier.
         attribute(:product_type_version, String, null: false, from: "productTypeVersion")
 
-        # @return [Array<ProductType>]
+        # @return [Array<ProductType>] A list of product types.
         attribute(:product_types, [ProductType], null: false, from: "productTypes")
       end
     end

data/lib/peddler/apis/product_type_definitions_2020_09_01/schema_link.rb

@@ -7,8 +7,9 @@ require "structure"
 module Peddler
   module APIs
     class ProductTypeDefinitions20200901
+      # A link to metadata schema.
       SchemaLink = Structure.new do
-        # @return [String] Checksum hash of the schema (Base64 MD5). Can be used to verify schema contents, identify
+        # @return [String] Checksum hash of the schema (Base64 MD5). Use this to verify schema contents, identify
         #   changes between schema versions, and for caching.
         attribute(:checksum, String, null: false)
 

data/lib/peddler/apis/product_type_definitions_2020_09_01.rb

@@ -22,12 +22,11 @@ module Peddler
       # @param keywords [Array<String>] A comma-delimited list of keywords to search product types. **Note:** Cannot be
       #   used with `itemName`.
       # @param marketplace_ids [Array<String>] A comma-delimited list of Amazon marketplace identifiers for the request.
-      # @param item_name [String] The title of the ASIN to get the product type recommendation. **Note:** Cannot be used
-      #   with `keywords`.
-      # @param locale [String] The locale for the display names in the response. Defaults to the primary locale of the
-      #   marketplace.
-      # @param search_locale [String] The locale used for the `keywords` and `itemName` parameters. Defaults to the
-      #   primary locale of the marketplace.
+      # @param item_name [String] Title of ASIN to get product type recommendation. **Note:** Cannot be used with
+      #   `keywords`.
+      # @param locale [String] Locale for display names in response. Defaults to primary locale of the marketplace.
+      # @param search_locale [String] Language used for `keywords` or `itemName` parameters. Defaults to primary locale
+      #   of the marketplace.
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def search_definitions_product_types(marketplace_ids, keywords: nil, item_name: nil, locale: nil,
@@ -53,7 +52,7 @@ module Peddler
       #   partner.
       # @param marketplace_ids [Array<String>] A comma-delimited list of Amazon marketplace identifiers for the request.
       #   Note: This parameter is limited to one marketplaceId at this time.
-      # @param product_type_version [String] The version of the Amazon product type to retrieve. Defaults to "LATEST",.
+      # @param product_type_version [String] The version of the Amazon product type to retrieve. Defaults to "LATEST".
       #   Prerelease versions of product type definitions may be retrieved with "RELEASE_CANDIDATE". If no prerelease
       #   version is currently available, the "LATEST" live version will be provided.
       # @param requirements [String] The name of the requirements set to retrieve requirements for.
@@ -62,10 +61,14 @@ module Peddler
       #   attributes without all the required attributes being present (such as for partial updates).
       # @param locale [String] Locale for retrieving display labels and other presentation details. Defaults to the
       #   default language of the first marketplace in the request.
+      # @param parentage_level [String] The parentage level of the listing to retrieve a schema for. When provided, the
+      #   schema is simplified by resolving all conditional logic related to the specified parentage level, resulting in
+      #   a smaller schema with fewer conditions.
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def get_definitions_product_type(product_type, marketplace_ids, seller_id: nil, product_type_version: "LATEST",
-        requirements: "LISTING", requirements_enforced: "ENFORCED", locale: "DEFAULT", rate_limit: 5.0)
+        requirements: "LISTING", requirements_enforced: "ENFORCED", locale: "DEFAULT", parentage_level: nil,
+        rate_limit: 5.0)
         path = "/definitions/2020-09-01/productTypes/#{percent_encode(product_type)}"
         params = {
           "sellerId" => seller_id,
@@ -74,6 +77,7 @@ module Peddler
           "requirements" => requirements,
           "requirementsEnforced" => requirements_enforced,
           "locale" => locale,
+          "parentageLevel" => parentage_level,
         }.compact
         parser = -> { ProductTypeDefinition }
         get(path, params:, rate_limit:, parser:)

data/lib/peddler/apis/replenishment_2022_11_07/get_selling_partner_metrics_request.rb

@@ -28,6 +28,11 @@ module Peddler
         # @return [String]
         attribute?(:aggregation_frequency, String, from: "aggregationFrequency")
 
+        # @return [GetSellingPartnerMetricsRequestFilters] Use these parameters to filter results. Any result must match
+        #   all provided parameters. For parameters that accept multiple values (arrays), the API returns results that
+        #   match at least one value in the array.
+        attribute?(:filters, GetSellingPartnerMetricsRequestFilters)
+
         # @return [Array<Metric>] The list of metrics requested. If no metric value is provided, data for all metrics
         #   will be returned.
         attribute?(:metrics, Array)

data/lib/peddler/apis/replenishment_2022_11_07/get_selling_partner_metrics_request_filters.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+# This file is generated. Do not edit.
+
+require "structure"
+
+module Peddler
+  module APIs
+    class Replenishment20221107
+      # Use these parameters to filter results. Any result must match all provided parameters. For parameters that
+      # accept multiple values (arrays), the API returns results that match at least one value in the array.
+      GetSellingPartnerMetricsRequestFilters = Structure.new do
+        # @return [Array<String>] A list of Amazon Standard Identification Numbers (ASINs) to filter by. ASIN filter is
+        #   supported for these metrics: SHIPPED_SUBSCRIPTION_UNITS, TOTAL_SUBSCRIPTIONS_REVENUE, ACTIVE_SUBSCRIPTIONS,
+        #   NOT_DELIVERED_DUE_TO_OOS, LOST_REVENUE_DUE_TO_OOS, COUPONS_REVENUE_PENETRATION,
+        #   SHARE_OF_COUPON_SUBSCRIPTIONS and REVENUE_PENETRATION.
+        attribute?(:asins, [String])
+
+        # @return [Array<String>] [Applicable only for US marketplace] A list of brand names to filter by. Brand name
+        #   filter is supported for these metrics: SHIPPED_SUBSCRIPTION_UNITS, TOTAL_SUBSCRIPTIONS_REVENUE,
+        #   ACTIVE_SUBSCRIPTIONS, NOT_DELIVERED_DUE_TO_OOS, LOST_REVENUE_DUE_TO_OOS, COUPONS_REVENUE_PENETRATION,
+        #   SHARE_OF_COUPON_SUBSCRIPTIONS, REVENUE_PENETRATION, SUBSCRIBER_NON_SUBSCRIBER_AVERAGE_REVENUE,
+        #   SUBSCRIBER_NON_SUBSCRIBER_AVERAGE_REORDERS, REVENUE_BY_DELIVERIES, SUBSCRIBER_RETENTION,
+        #   REVENUE_PENETRATION_BY_SELLER_FUNDING, SUBSCRIBER_LIFETIME_VALUE_BY_CUSTOMER_SEGMENT and
+        #   SIGNUP_CONVERSION_BY_SELLER_FUNDING.
+        attribute?(:brand_names, [String], from: "brandNames")
+
+        # @return [Array<FulfillmentChannelType>] [Applicable only for Sellers] The fulfillment channel types to filter
+        #   by. Fulfillment channel type filter is supported for these metrics: SHIPPED_SUBSCRIPTION_UNITS,
+        #   TOTAL_SUBSCRIPTIONS_REVENUE, ACTIVE_SUBSCRIPTIONS, NOT_DELIVERED_DUE_TO_OOS, LOST_REVENUE_DUE_TO_OOS,
+        #   COUPONS_REVENUE_PENETRATION, SHARE_OF_COUPON_SUBSCRIPTIONS and REVENUE_PENETRATION.
+        attribute?(:fulfillment_channel_types, Array, from: "fulfillmentChannelTypes")
+
+        # @return [Array<String>] [Applicable only for Vendors] A list of product group names to filter by. Product
+        #   group filter is supported for these metrics: SHIPPED_SUBSCRIPTION_UNITS, TOTAL_SUBSCRIPTIONS_REVENUE,
+        #   ACTIVE_SUBSCRIPTIONS, NOT_DELIVERED_DUE_TO_OOS, LOST_REVENUE_DUE_TO_OOS, COUPONS_REVENUE_PENETRATION,
+        #   SHARE_OF_COUPON_SUBSCRIPTIONS and REVENUE_PENETRATION.
+        attribute?(:product_groups, [String], from: "productGroups")
+
+        # @return [Array<String>] [Applicable only for Sellers] A list of SKUs to filter by. SKU filter is supported for
+        #   these metrics: SHIPPED_SUBSCRIPTION_UNITS, TOTAL_SUBSCRIPTIONS_REVENUE, ACTIVE_SUBSCRIPTIONS,
+        #   NOT_DELIVERED_DUE_TO_OOS, LOST_REVENUE_DUE_TO_OOS, COUPONS_REVENUE_PENETRATION,
+        #   SHARE_OF_COUPON_SUBSCRIPTIONS and REVENUE_PENETRATION.
+        attribute?(:skus, [String])
+      end
+    end
+  end
+end

data/lib/peddler/apis/replenishment_2022_11_07/get_selling_partner_metrics_response_metric.rb

@@ -97,7 +97,7 @@ module Peddler
         #   5% or above seller-funded discount over the last 12 months. Applicable to `PERFORMANCE` `timePeriodType`.
         attribute?(:revenue_penetration_for5_plus_percent_seller_funding, Float, from: "revenuePenetrationFor5PlusPercentSellerFunding")
 
-        # @return [Float] The percentage of new subscriptions acquired through coupons. Applicable to `PERFORMANCE`
+        # @return [Float] The percentage of new subscriptions from coupons. Applicable to `PERFORMANCE`
         #   `timePeriodType`.
         attribute?(:share_of_coupon_subscriptions, Float, from: "shareOfCouponSubscriptions")
 
@@ -105,20 +105,20 @@ module Peddler
         #   `PERFORMANCE` and `FORECAST` `timePeriodType`.
         attribute?(:shipped_subscription_units, Float, from: "shippedSubscriptionUnits")
 
-        # @return [Float] Percentage of subscriptions created by offers with 0% seller-funded discount out of the total
-        #   number of new orders placed over the past 12 months
+        # @return [Float] Percentage of subscriptions from offers with 0% seller-funded discount out of the total number
+        #   of new orders placed over the past 12 months.
         attribute?(:signup_conversion_for0_percent_seller_funding, Float, from: "signupConversionFor0PercentSellerFunding")
 
-        # @return [Float] [Applicable only for Sellers] Percentage of subscriptions created by offers with 10%
-        #   seller-funded discount out of the total number of new orders placed over the past 12 months
+        # @return [Float] [Applicable only for Sellers] Percentage of subscriptions from offers with 10% seller-funded
+        #   discount out of the total number of new orders placed over the past 12 months.
         attribute?(:signup_conversion_for10_percent_seller_funding, Float, from: "signupConversionFor10PercentSellerFunding")
 
-        # @return [Float] [Applicable only for Sellers] Percentage of subscriptions created by offers with 5%
-        #   seller-funded discount out of the total number of new orders placed over the past 12 months
+        # @return [Float] [Applicable only for Sellers] Percentage of subscriptions from offers with 5% seller-funded
+        #   discount out of the total number of new orders placed over the past 12 months.
         attribute?(:signup_conversion_for5_percent_seller_funding, Float, from: "signupConversionFor5PercentSellerFunding")
 
-        # @return [Float] [Applicable only for Vendors] Percentage of subscriptions created by offers with 5% or above
-        #   seller-funded discount out of the total number of new orders placed over the past 12 months
+        # @return [Float] [Applicable only for Vendors] Percentage of subscriptions from offers with 5% or above
+        #   seller-funded discount out of the total number of new orders placed over the past 12 months.
         attribute?(:signup_conversion_for5_plus_percent_seller_funding, Float, from: "signupConversionFor5PlusPercentSellerFunding")
 
         # @return [Float] The average reorders per subscriber of the program over a period of 12 months. Applicable to

data/lib/peddler/apis/replenishment_2022_11_07/list_offer_metrics_request.rb

@@ -10,8 +10,8 @@ module Peddler
       # The request body for the `listOfferMetrics` operation.
       ListOfferMetricsRequest = Structure.new do
         # @return [ListOfferMetricsRequestFilters] Use these parameters to filter results. Any result must match all
-        #   provided parameters. For any parameter that is an array, the result must match at least one element in the
-        #   provided array.
+        #   provided parameters. For parameters that accept multiple values (arrays), the API returns results that match
+        #   at least one value in the array.
         attribute(:filters, ListOfferMetricsRequestFilters, null: false)
 
         # @return [ListOfferMetricsRequestPagination] Use these parameters to paginate through the response.