peddler 3.0.0.beta1 → 4.0.0

data/lib/peddler/{api → apis}/notifications_v1.rb

@@ -3,7 +3,13 @@
 require "peddler/api"
 
 module Peddler
-  class API
+  class << self
+    def notifications_v1(...)
+      APIs::NotificationsV1.new(...)
+    end
+  end
+
+  module APIs
     # Selling Partner API for Notifications
     #
     # The Selling Partner API for Notifications lets you subscribe to notifications that are relevant to a selling
@@ -16,15 +22,19 @@ module Peddler
       # subscription's information. You can use this API to get subscription information when you do not have a
       # subscription identifier.
       #
-      # @param [String] payload_version The version of the payload object to be used in the notification.
-      # @return [Hash] The API response
-      def get_subscription(payload_version: nil)
+      # @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 rate_limit [Float] Requests per second
+      # @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).
+      # @return [Peddler::Response] The API response
+      def get_subscription(notification_type, payload_version: nil, rate_limit: 1.0)
         path = "/notifications/v1/subscriptions/#{notification_type}"
         params = {
           "payloadVersion" => payload_version,
         }.compact
 
-        rate_limit(1.0).get(path, params:)
+        meter(rate_limit).get(path, params:)
       end
 
       # Creates a subscription for the specified notification type to be delivered to the specified destination. Before
@@ -32,24 +42,32 @@ module Peddler
       # where the specified notification type supports multiple payload versions, you can utilize this API to subscribe
       # to a different payload version if you already have an existing subscription for a different payload version.
       #
-      # @param [Hash] body
-      # @return [Hash] The API response
-      def create_subscription(body)
+      # @note This operation can make a static sandbox call.
+      # @param body [Hash]
+      # @param rate_limit [Float] Requests per second
+      # @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).
+      # @return [Peddler::Response] The API response
+      def create_subscription(body, notification_type, rate_limit: 1.0)
         path = "/notifications/v1/subscriptions/#{notification_type}"
 
-        rate_limit(1.0).post(path, body:)
+        meter(rate_limit).post(path, body:)
       end
 
       # 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).
       #
-      # @param [String] subscription_id The identifier for the subscription that you want to get.
-      # @return [Hash] The API response
-      def get_subscription_by_id(subscription_id)
+      # @note This operation can make a static sandbox call.
+      # @param subscription_id [String] The identifier for the subscription that you want to get.
+      # @param rate_limit [Float] Requests per second
+      # @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).
+      # @return [Peddler::Response] The API response
+      def get_subscription_by_id(subscription_id, notification_type, rate_limit: 1.0)
         path = "/notifications/v1/subscriptions/#{notification_type}/#{subscription_id}"
 
-        rate_limit(1.0).get(path)
+        meter(rate_limit).get(path)
       end
 
       # Deletes the subscription indicated by the subscription identifier and notification type that you specify. The
@@ -58,56 +76,69 @@ module Peddler
       # `deleteSubscriptionById` operation is grantless. For more information, refer to [Grantless
       # operations](https://developer-docs.amazon.com/sp-api/docs/grantless-operations).
       #
-      # @param [String] subscription_id The identifier for the subscription that you want to delete.
-      # @return [Hash] The API response
-      def delete_subscription_by_id(subscription_id)
+      # @note This operation can make a static sandbox call.
+      # @param subscription_id [String] The identifier for the subscription that you want to delete.
+      # @param rate_limit [Float] Requests per second
+      # @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).
+      # @return [Peddler::Response] The API response
+      def delete_subscription_by_id(subscription_id, notification_type, rate_limit: 1.0)
         path = "/notifications/v1/subscriptions/#{notification_type}/#{subscription_id}"
 
-        rate_limit(1.0).delete(path)
+        meter(rate_limit).delete(path)
       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).
-      # @return [Hash] The API response
-      def get_destinations
+      #
+      # @note This operation can make a static sandbox call.
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def get_destinations(rate_limit: 1.0)
         path = "/notifications/v1/destinations"
 
-        rate_limit(1.0).get(path)
+        meter(rate_limit).get(path)
       end
 
       # 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).
       #
-      # @param [Hash] body
-      # @return [Hash] The API response
-      def create_destination(body)
+      # @note This operation can make a static sandbox call.
+      # @param body [Hash]
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def create_destination(body, rate_limit: 1.0)
         path = "/notifications/v1/destinations"
 
-        rate_limit(1.0).post(path, body:)
+        meter(rate_limit).post(path, body:)
       end
 
       # 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).
       #
-      # @param [String] destination_id The identifier generated when you created the destination.
-      # @return [Hash] The API response
-      def get_destination(destination_id)
+      # @note This operation can make a static sandbox call.
+      # @param destination_id [String] The identifier generated when you created the destination.
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def get_destination(destination_id, rate_limit: 1.0)
         path = "/notifications/v1/destinations/#{destination_id}"
 
-        rate_limit(1.0).get(path)
+        meter(rate_limit).get(path)
       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).
       #
-      # @param [String] destination_id The identifier for the destination that you want to delete.
-      # @return [Hash] The API response
-      def delete_destination(destination_id)
+      # @note This operation can make a static sandbox call.
+      # @param destination_id [String] The identifier for the destination that you want to delete.
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def delete_destination(destination_id, rate_limit: 1.0)
         path = "/notifications/v1/destinations/#{destination_id}"
 
-        rate_limit(1.0).delete(path)
+        meter(rate_limit).delete(path)
       end
     end
   end

data/lib/peddler/{api → apis}/orders_v0.rb

@@ -3,8 +3,14 @@
 require "peddler/api"
 
 module Peddler
-  class API
-    # Selling Partner API for Orders
+  class << self
+    def orders_v0(...)
+      APIs::OrdersV0.new(...)
+    end
+  end
+
+  module APIs
+    # Orders v0
     #
     # Use the Orders Selling Partner API to programmatically retrieve order information. With this API, you can develop
     # fast, flexible, and custom applications to manage order synchronization, perform order research, and create
@@ -16,29 +22,30 @@ module Peddler
       # types of orders, you can apply filters to your request. `NextToken` doesn't affect any filters that you include
       # in your request; it only impacts the pagination for the filtered orders response.
       #
-      # @param [String] created_after Use this date to select orders created after (or at) a specified time. Only orders
+      # @note This operation can make a static sandbox call.
+      # @param created_after [String] Use this date to select orders created after (or at) a specified time. Only orders
       #   placed after the specified time are returned. The date must be in [ISO
       #   8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) format. **Note**: Either the `CreatedAfter`
       #   parameter or the `LastUpdatedAfter` parameter is required. Both cannot be empty. `LastUpdatedAfter` and
       #   `LastUpdatedBefore` cannot be set when `CreatedAfter` is set.
-      # @param [String] created_before Use this date to select orders created before (or at) a specified time. Only
+      # @param created_before [String] Use this date to select orders created before (or at) a specified time. Only
       #   orders placed before the specified time are returned. The date must be in [ISO
       #   8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) format. **Note**: `CreatedBefore` is optional
       #   when `CreatedAfter` is set. If specified, `CreatedBefore` must be equal to or after the `CreatedAfter` date
       #   and at least two minutes before current time.
-      # @param [String] last_updated_after Use this date to select orders that were last updated after (or at) a
+      # @param last_updated_after [String] Use this date to select orders that were last updated after (or at) a
       #   specified time. An update is defined as any change in order status, including the creation of a new order.
       #   Includes updates made by Amazon and by the seller. The date must be in [ISO
       #   8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) format. **Note**: Either the `CreatedAfter`
       #   parameter or the `LastUpdatedAfter` parameter is required. Both cannot be empty. `CreatedAfter` or
       #   `CreatedBefore` cannot be set when `LastUpdatedAfter` is set.
-      # @param [String] last_updated_before Use this date to select orders that were last updated before (or at) a
+      # @param last_updated_before [String] Use this date to select orders that were last updated before (or at) a
       #   specified time. An update is defined as any change in order status, including the creation of a new order.
       #   Includes updates made by Amazon and by the seller. The date must be in [ISO
       #   8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) format. **Note**: `LastUpdatedBefore` is
       #   optional when `LastUpdatedAfter` is set. But if specified, `LastUpdatedBefore` must be equal to or after the
       #   `LastUpdatedAfter` date and at least two minutes before current time.
-      # @param [Array<String>] order_statuses A list of `OrderStatus` values used to filter the results. **Possible
+      # @param order_statuses [Array<String>] A list of `OrderStatus` values used to filter the results. **Possible
       #   values:** - `PendingAvailability` (This status is available for pre-orders only. The order has been placed,
       #   payment has not been authorized, and the release date of the item is in the future.) - `Pending` (The order
       #   has been placed but payment has not been authorized.) - `Unshipped` (Payment has been authorized and the order
@@ -47,23 +54,23 @@ module Peddler
       #   `InvoiceUnconfirmed` (All items in the order have been shipped. The seller has not yet given confirmation to
       #   Amazon that the invoice has been shipped to the buyer.) - `Canceled` (The order has been canceled.) -
       #   `Unfulfillable` (The order cannot be fulfilled. This state applies only to Multi-Channel Fulfillment orders.)
-      # @param [Array<String>] marketplace_ids A list of `MarketplaceId` values. Used to select orders that were placed
+      # @param marketplace_ids [Array<String>] A list of `MarketplaceId` values. Used to select orders that were placed
       #   in the specified marketplaces. Refer to [Marketplace
       #   IDs](https://developer-docs.amazon.com/sp-api/docs/marketplace-ids) for a complete list of `marketplaceId`
       #   values.
-      # @param [Array<String>] fulfillment_channels A list that indicates how an order was fulfilled. Filters the
+      # @param fulfillment_channels [Array<String>] A list that indicates how an order was fulfilled. Filters the
       #   results by fulfillment channel. **Possible values**: `AFN` (fulfilled by Amazon), `MFN` (fulfilled by seller).
-      # @param [Array<String>] payment_methods A list of payment method values. Use this field to select orders that
+      # @param payment_methods [Array<String>] A list of payment method values. Use this field to select orders that
       #   were paid with the specified payment methods. **Possible values**: `COD` (cash on delivery), `CVS`
       #   (convenience store), `Other` (Any payment method other than COD or CVS).
-      # @param [String] buyer_email The email address of a buyer. Used to select orders that contain the specified email
+      # @param buyer_email [String] The email address of a buyer. Used to select orders that contain the specified email
       #   address.
-      # @param [String] seller_order_id An order identifier that is specified by the seller. Used to select only the
+      # @param seller_order_id [String] An order identifier that is specified by the seller. Used to select only the
       #   orders that match the order identifier. If `SellerOrderId` is specified, then `FulfillmentChannels`,
       #   `OrderStatuses`, `PaymentMethod`, `LastUpdatedAfter`, LastUpdatedBefore, and `BuyerEmail` cannot be specified.
-      # @param [Integer] max_results_per_page A number that indicates the maximum number of orders that can be returned
+      # @param max_results_per_page [Integer] A number that indicates the maximum number of orders that can be returned
       #   per page. Value must be 1 - 100. Default 100.
-      # @param [Array<String>] easy_ship_shipment_statuses A list of `EasyShipShipmentStatus` values. Used to select
+      # @param easy_ship_shipment_statuses [Array<String>] A list of `EasyShipShipmentStatus` values. Used to select
       #   Easy Ship orders with statuses that match the specified values. If `EasyShipShipmentStatus` is specified, only
       #   Amazon Easy Ship orders are returned. **Possible values:** - `PendingSchedule` (The package is awaiting the
       #   schedule for pick-up.) - `PendingPickUp` (Amazon has not yet picked up the package from the seller.) -
@@ -76,41 +83,41 @@ module Peddler
       #   seller.) - `ReturnedToSeller` (The package was not delivered and was returned to the seller.) - `Lost` (The
       #   package is lost.) - `OutForDelivery` (The package is out for delivery.) - `Damaged` (The package was damaged
       #   by the carrier.)
-      # @param [Array<String>] electronic_invoice_statuses A list of `ElectronicInvoiceStatus` values. Used to select
+      # @param electronic_invoice_statuses [Array<String>] A list of `ElectronicInvoiceStatus` values. Used to select
       #   orders with electronic invoice statuses that match the specified values. **Possible values:** - `NotRequired`
       #   (Electronic invoice submission is not required for this order.) - `NotFound` (The electronic invoice was not
       #   submitted for this order.) - `Processing` (The electronic invoice is being processed for this order.) -
       #   `Errored` (The last submitted electronic invoice was rejected for this order.) - `Accepted` (The last
       #   submitted electronic invoice was submitted and accepted.)
-      # @param [String] next_token A string token returned in the response of your previous request.
-      # @param [Array<String>] amazon_order_ids A list of `AmazonOrderId` values. An `AmazonOrderId` is an
+      # @param next_token [String] A string token returned in the response of your previous request.
+      # @param amazon_order_ids [Array<String>] A list of `AmazonOrderId` values. An `AmazonOrderId` is an
       #   Amazon-defined order identifier, in 3-7-7 format.
-      # @param [String] actual_fulfillment_supply_source_id The `sourceId` of the location from where you want the order
+      # @param actual_fulfillment_supply_source_id [String] The `sourceId` of the location from where you want the order
       #   fulfilled.
-      # @param [Boolean] is_ispu When true, this order is marked to be picked up from a store rather than delivered.
-      # @param [String] store_chain_store_id The store chain store identifier. Linked to a specific store in a store
+      # @param is_ispu [Boolean] When true, this order is marked to be picked up from a store rather than delivered.
+      # @param store_chain_store_id [String] The store chain store identifier. Linked to a specific store in a store
       #   chain.
-      # @param [String] earliest_delivery_date_before Use this date to select orders with a earliest delivery date
+      # @param earliest_delivery_date_before [String] Use this date to select orders with a earliest delivery date
       #   before (or at) a specified time. The date must be in [ISO
       #   8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) format.
-      # @param [String] earliest_delivery_date_after Use this date to select orders with a earliest delivery date after
+      # @param earliest_delivery_date_after [String] Use this date to select orders with a earliest delivery date after
       #   (or at) a specified time. The date must be in [ISO
       #   8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) format.
-      # @param [String] latest_delivery_date_before Use this date to select orders with a latest delivery date before
+      # @param latest_delivery_date_before [String] Use this date to select orders with a latest delivery date before
       #   (or at) a specified time. The date must be in [ISO
       #   8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) format.
-      # @param [String] latest_delivery_date_after Use this date to select orders with a latest delivery date after (or
+      # @param latest_delivery_date_after [String] Use this date to select orders with a latest delivery date after (or
       #   at) a specified time. The date must be in [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601)
       #   format.
-      # @return [Hash] The API response
-      def get_orders(
-        marketplace_ids, created_after: nil, created_before: nil, last_updated_after: nil, last_updated_before: nil,
-        order_statuses: nil, fulfillment_channels: nil, payment_methods: nil, buyer_email: nil, seller_order_id: nil,
-        max_results_per_page: nil, easy_ship_shipment_statuses: nil, electronic_invoice_statuses: nil, next_token: nil,
-        amazon_order_ids: nil, actual_fulfillment_supply_source_id: nil, is_ispu: nil, store_chain_store_id: nil,
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def get_orders(marketplace_ids, created_after: nil, created_before: nil, last_updated_after: nil,
+        last_updated_before: nil, order_statuses: nil, fulfillment_channels: nil, payment_methods: nil,
+        buyer_email: nil, seller_order_id: nil, max_results_per_page: nil, easy_ship_shipment_statuses: nil,
+        electronic_invoice_statuses: nil, next_token: nil, amazon_order_ids: nil,
+        actual_fulfillment_supply_source_id: nil, is_ispu: nil, store_chain_store_id: nil,
         earliest_delivery_date_before: nil, earliest_delivery_date_after: nil, latest_delivery_date_before: nil,
-        latest_delivery_date_after: nil
-      )
+        latest_delivery_date_after: nil, rate_limit: 0.0167)
         path = "/orders/v0/orders"
         params = {
           "CreatedAfter" => created_after,
@@ -137,47 +144,43 @@ module Peddler
           "LatestDeliveryDateAfter" => latest_delivery_date_after,
         }.compact
 
-        rate_limit(0.0167).get(path, params:)
+        meter(rate_limit).get(path, params:)
       end
 
       # Returns the order that you specify.
       #
-      # @param [String] order_id An Amazon-defined order identifier, in 3-7-7 format.
-      # @return [Hash] The API response
-      def get_order(order_id)
+      # @note This operation can make a static sandbox call.
+      # @param order_id [String] An Amazon-defined order identifier, in 3-7-7 format.
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def get_order(order_id, rate_limit: 0.5)
         path = "/orders/v0/orders/#{order_id}"
 
-        rate_limit(0.5).get(path)
+        meter(rate_limit).get(path)
       end
 
       # Returns buyer information for the order that you specify.
       #
-      # @param [String] order_id An `orderId` is an Amazon-defined order identifier, in 3-7-7 format.
-      # @return [Hash] The API response
-      def get_order_buyer_info(order_id)
+      # @note This operation can make a static sandbox call.
+      # @param order_id [String] An `orderId` is an Amazon-defined order identifier, in 3-7-7 format.
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def get_order_buyer_info(order_id, rate_limit: 0.5)
         path = "/orders/v0/orders/#{order_id}/buyerInfo"
 
-        rate_limit(0.5).get(path)
+        meter(rate_limit).get(path)
       end
 
       # Returns the shipping address for the order that you specify.
       #
-      # @param [String] order_id An `orderId` is an Amazon-defined order identifier, in 3-7-7 format.
-      # @return [Hash] The API response
-      def get_order_address(order_id)
+      # @note This operation can make a static sandbox call.
+      # @param order_id [String] An `orderId` is an Amazon-defined order identifier, in 3-7-7 format.
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def get_order_address(order_id, rate_limit: 0.5)
         path = "/orders/v0/orders/#{order_id}/address"
 
-        rate_limit(0.5).get(path)
-      end
-
-      # Returns the fulfillment instructions for the order that you specify.
-      #
-      # @param [String] order_id An Amazon-defined order identifier, in 3-7-7 format.
-      # @return [Hash] The API response
-      def get_order_fulfillment_instructions(order_id)
-        path = "/orders/v0/orders/#{order_id}/fulfillmentInstructions"
-
-        rate_limit(0.5).get(path)
+        meter(rate_limit).get(path)
       end
 
       # Returns detailed order item information for the order that you specify. If `NextToken` is provided, it's used to
@@ -188,76 +191,88 @@ module Peddler
       # Shipped, or Shipped state, the getOrderItems operation returns information about pricing, taxes, shipping
       # charges, gift status and promotions for the order items in the order.
       #
-      # @param [String] order_id An Amazon-defined order identifier, in 3-7-7 format.
-      # @param [String] next_token A string token returned in the response of your previous request.
-      # @return [Hash] The API response
-      def get_order_items(order_id, next_token: nil)
+      # @note This operation can make a static sandbox call.
+      # @param order_id [String] An Amazon-defined order identifier, in 3-7-7 format.
+      # @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 get_order_items(order_id, next_token: nil, rate_limit: 0.5)
         path = "/orders/v0/orders/#{order_id}/orderItems"
         params = {
           "NextToken" => next_token,
         }.compact
 
-        rate_limit(0.5).get(path, params:)
+        meter(rate_limit).get(path, params:)
       end
 
       # Returns buyer information for the order items in the order that you specify.
       #
-      # @param [String] order_id An Amazon-defined order identifier, in 3-7-7 format.
-      # @param [String] next_token A string token returned in the response of your previous request.
-      # @return [Hash] The API response
-      def get_order_items_buyer_info(order_id, next_token: nil)
+      # @note This operation can make a static sandbox call.
+      # @param order_id [String] An Amazon-defined order identifier, in 3-7-7 format.
+      # @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 get_order_items_buyer_info(order_id, next_token: nil, rate_limit: 0.5)
         path = "/orders/v0/orders/#{order_id}/orderItems/buyerInfo"
         params = {
           "NextToken" => next_token,
         }.compact
 
-        rate_limit(0.5).get(path, params:)
+        meter(rate_limit).get(path, params:)
       end
 
       # Update the shipment status for an order that you specify.
       #
-      # @param [String] order_id An Amazon-defined order identifier, in 3-7-7 format.
-      # @param [Hash] payload The request body for the `updateShipmentStatus` operation.
-      # @return [Hash] The API response
-      def update_shipment_status(order_id, payload)
+      # @note This operation can make a static sandbox call.
+      # @param order_id [String] An Amazon-defined order identifier, in 3-7-7 format.
+      # @param payload [Hash] The request body for the `updateShipmentStatus` operation.
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def update_shipment_status(order_id, payload, rate_limit: 5.0)
         path = "/orders/v0/orders/#{order_id}/shipment"
         body = payload
 
-        rate_limit(5.0).post(path, body:)
+        meter(rate_limit).post(path, body:)
       end
 
       # Returns regulated information for the order that you specify.
       #
-      # @param [String] order_id An Amazon-defined order identifier, in 3-7-7 format.
-      # @return [Hash] The API response
-      def get_order_regulated_info(order_id)
+      # @note This operation can make a static sandbox call.
+      # @param order_id [String] An Amazon-defined order identifier, in 3-7-7 format.
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def get_order_regulated_info(order_id, rate_limit: 0.5)
         path = "/orders/v0/orders/#{order_id}/regulatedInfo"
 
-        rate_limit(0.5).get(path)
+        meter(rate_limit).get(path)
       end
 
       # Updates (approves or rejects) the verification status of an order containing regulated products.
       #
-      # @param [String] order_id An Amazon-defined order identifier, in 3-7-7 format.
-      # @param [Hash] payload The request body for the `updateVerificationStatus` operation.
-      # @return [Hash] The API response
-      def update_verification_status(order_id, payload)
+      # @note This operation can make a static sandbox call.
+      # @param order_id [String] An Amazon-defined order identifier, in 3-7-7 format.
+      # @param payload [Hash] The request body for the `updateVerificationStatus` operation.
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def update_verification_status(order_id, payload, rate_limit: 0.5)
         path = "/orders/v0/orders/#{order_id}/regulatedInfo"
         body = payload
 
-        rate_limit(0.5).patch(path, body:)
+        meter(rate_limit).patch(path, body:)
       end
 
       # Updates the shipment confirmation status for a specified order.
       #
-      # @param [String] order_id An Amazon-defined order identifier, in 3-7-7 format.
-      # @param [Hash] payload Request body of `confirmShipment`.
-      # @return [Hash] The API response
-      def confirm_shipment(order_id, payload)
+      # @note This operation can make a static sandbox call.
+      # @param order_id [String] An Amazon-defined order identifier, in 3-7-7 format.
+      # @param payload [Hash] Request body of `confirmShipment`.
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def confirm_shipment(order_id, payload, rate_limit: 2.0)
         path = "/orders/v0/orders/#{order_id}/shipmentConfirmation"
         body = payload
 
-        rate_limit(2.0).post(path, body:)
+        meter(rate_limit).post(path, body:)
       end
     end
   end

data/lib/peddler/apis/product_fees_v0.rb

@@ -0,0 +1,77 @@
+# frozen_string_literal: true
+
+require "peddler/api"
+
+module Peddler
+  class << self
+    def product_fees_v0(...)
+      APIs::ProductFeesV0.new(...)
+    end
+  end
+
+  module APIs
+    # Selling Partner API for Product Fees
+    #
+    # The Selling Partner API for Product Fees lets you programmatically retrieve estimated fees for a product. You can
+    # then account for those fees in your pricing.
+    class ProductFeesV0 < API
+      # Returns the estimated fees for the item indicated by the specified seller SKU in the marketplace specified in
+      # the request body. **Note:** The parameters associated with this operation may contain special characters that
+      # require URL encoding to call the API. To avoid errors with SKUs when encoding URLs, refer to [URL
+      # Encoding](https://developer-docs.amazon.com/sp-api/docs/url-encoding). You can call `getMyFeesEstimateForSKU`
+      # for an item on behalf of a selling partner before the selling partner sets the item's price. The selling partner
+      # can then take any estimated fees into account. Each fees estimate request must include an original identifier.
+      # This identifier is included in the fees estimate so that you can correlate a fees estimate with the original
+      # request. **Note:** This identifier value is used to identify an estimate. Actual costs may vary. Search "fees"
+      # in [Seller Central](https://sellercentral.amazon.com/) and consult the store-specific fee schedule for the most
+      # up-to-date information. **Note:** When sellers use the `getMyFeesEstimateForSKU` operation with their
+      # `SellerSKU`, they get accurate fees based on real item measurements, but only after they've sent their items to
+      # Amazon.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param body [Hash]
+      # @param seller_sku [String] Used to identify an item in the given marketplace. SellerSKU is qualified by the
+      #   seller's SellerId, which is included with every operation that you submit.
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def get_my_fees_estimate_for_sku(body, seller_sku, rate_limit: 1.0)
+        path = "/products/fees/v0/listings/#{seller_sku}/feesEstimate"
+
+        meter(rate_limit).post(path, body:)
+      end
+
+      # Returns the estimated fees for the item indicated by the specified ASIN in the marketplace specified in the
+      # request body. You can call `getMyFeesEstimateForASIN` for an item on behalf of a selling partner before the
+      # selling partner sets the item's price. The selling partner can then take estimated fees into account. Each fees
+      # request must include an original identifier. This identifier is included in the fees estimate so you can
+      # correlate a fees estimate with the original request. **Note:** This identifier value is used to identify an
+      # estimate. Actual costs may vary. Search "fees" in [Seller Central](https://sellercentral.amazon.com/) and
+      # consult the store-specific fee schedule for the most up-to-date information. **Note:** When using the
+      # `getMyFeesEstimateForASIN` operation with an ASIN, the fee estimates might be different. This is because these
+      # estimates use the item's catalog size, which might not always match the actual size of the item sent to Amazon.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param body [Hash]
+      # @param asin [String] The Amazon Standard Identification Number (ASIN) of the item.
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def get_my_fees_estimate_for_asin(body, asin, rate_limit: 1.0)
+        path = "/products/fees/v0/items/#{asin}/feesEstimate"
+
+        meter(rate_limit).post(path, body:)
+      end
+
+      # Returns the estimated fees for a list of products.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param body [Hash]
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def get_my_fees_estimates(body, rate_limit: 0.5)
+        path = "/products/fees/v0/feesEstimate"
+
+        meter(rate_limit).post(path, body:)
+      end
+    end
+  end
+end