peddler 3.0.0.beta1 → 4.0.0

data/lib/peddler/apis/listings_items_2021_08_01.rb

@@ -0,0 +1,136 @@
+# frozen_string_literal: true
+
+require "peddler/api"
+
+module Peddler
+  class << self
+    def listings_items_2021_08_01(...)
+      APIs::ListingsItems20210801.new(...)
+    end
+  end
+
+  module APIs
+    # Listings Items v2021-08-01
+    #
+    # The Selling Partner API for Listings Items (Listings Items API) provides programmatic access to selling partner
+    # listings on Amazon. Use this API in collaboration with the Selling Partner API for Product Type Definitions, which
+    # you use to retrieve the information about Amazon product types needed to use the Listings Items API. For more
+    # information, see the [Listings Items API Use Case
+    # Guide](https://developer-docs.amazon.com/sp-api/docs/listings-items-api-v2021-08-01-use-case-guide).
+    class ListingsItems20210801 < API
+      # Delete a listings item for a selling partner. **Note:** The parameters associated with this operation may
+      # contain special characters that must be encoded to successfully call the API. To avoid errors with SKUs when
+      # encoding URLs, refer to [URL Encoding](https://developer-docs.amazon.com/sp-api/docs/url-encoding).
+      #
+      # @note This operation can make a static sandbox call.
+      # @param seller_id [String] A selling partner identifier, such as a merchant account or vendor code.
+      # @param sku [String] A selling partner provided identifier for an Amazon listing.
+      # @param marketplace_ids [Array<String>] A comma-delimited list of Amazon marketplace identifiers for the request.
+      # @param issue_locale [String] A locale for localization of issues. When not provided, the default language code
+      #   of the first marketplace is used. Examples: `en_US`, `fr_CA`, `fr_FR`. Localized messages default to `en_US`
+      #   when a localization is not available in the specified locale.
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def delete_listings_item(seller_id, sku, marketplace_ids, issue_locale: nil, rate_limit: 5.0)
+        path = "/listings/2021-08-01/items/#{seller_id}/#{sku}"
+        params = {
+          "marketplaceIds" => marketplace_ids,
+          "issueLocale" => issue_locale,
+        }.compact
+
+        meter(rate_limit).delete(path, params:)
+      end
+
+      # Returns details about a listings item for a selling partner. **Note:** The parameters associated with this
+      # operation may contain special characters that must be encoded to successfully call the API. To avoid errors with
+      # SKUs when encoding URLs, refer to [URL Encoding](https://developer-docs.amazon.com/sp-api/docs/url-encoding).
+      #
+      # @note This operation can make a static sandbox call.
+      # @param seller_id [String] A selling partner identifier, such as a merchant account or vendor code.
+      # @param sku [String] A selling partner provided identifier for an Amazon listing.
+      # @param marketplace_ids [Array<String>] A comma-delimited list of Amazon marketplace identifiers for the request.
+      # @param issue_locale [String] A locale for localization of issues. When not provided, the default language code
+      #   of the first marketplace is used. Examples: `en_US`, `fr_CA`, `fr_FR`. Localized messages default to `en_US`
+      #   when a localization is not available in the specified locale.
+      # @param included_data [Array<String>] A comma-delimited list of data sets to include in the response. Default:
+      #   `summaries`.
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def get_listings_item(seller_id, sku, marketplace_ids, issue_locale: nil, included_data: ["summaries"],
+        rate_limit: 5.0)
+        path = "/listings/2021-08-01/items/#{seller_id}/#{sku}"
+        params = {
+          "marketplaceIds" => marketplace_ids,
+          "issueLocale" => issue_locale,
+          "includedData" => included_data,
+        }.compact
+
+        meter(rate_limit).get(path, params:)
+      end
+
+      # Partially update (patch) a listings item for a selling partner. Only top-level listings item attributes can be
+      # patched. Patching nested attributes is not supported. **Note:** This operation has a throttling rate of one
+      # request per second when `mode` is `VALIDATION_PREVIEW`. **Note:** The parameters associated with this operation
+      # may contain special characters that must be encoded to successfully call the API. To avoid errors with SKUs when
+      # encoding URLs, refer to [URL Encoding](https://developer-docs.amazon.com/sp-api/docs/url-encoding).
+      #
+      # @note This operation can make a static sandbox call.
+      # @param seller_id [String] A selling partner identifier, such as a merchant account or vendor code.
+      # @param sku [String] A selling partner provided identifier for an Amazon listing.
+      # @param marketplace_ids [Array<String>] A comma-delimited list of Amazon marketplace identifiers for the request.
+      # @param included_data [Array<String>] A comma-delimited list of data sets to include in the response. Default:
+      #   `issues`.
+      # @param mode [String] The mode of operation for the request.
+      # @param issue_locale [String] A locale for localization of issues. When not provided, the default language code
+      #   of the first marketplace is used. Examples: `en_US`, `fr_CA`, `fr_FR`. Localized messages default to `en_US`
+      #   when a localization is not available in the specified locale.
+      # @param body [Hash] The request body schema for the `patchListingsItem` operation.
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def patch_listings_item(seller_id, sku, marketplace_ids, body, included_data: ["issues"], mode: nil,
+        issue_locale: nil, rate_limit: 5.0)
+        path = "/listings/2021-08-01/items/#{seller_id}/#{sku}"
+        params = {
+          "marketplaceIds" => marketplace_ids,
+          "includedData" => included_data,
+          "mode" => mode,
+          "issueLocale" => issue_locale,
+        }.compact
+
+        meter(rate_limit).patch(path, body:, params:)
+      end
+
+      # Creates or fully updates an existing listings item for a selling partner. **Note:** This operation has a
+      # throttling rate of one request per second when `mode` is `VALIDATION_PREVIEW`. **Note:** The parameters
+      # associated with this operation may contain special characters that must be encoded to successfully call the API.
+      # To avoid errors with SKUs when encoding URLs, refer to [URL
+      # Encoding](https://developer-docs.amazon.com/sp-api/docs/url-encoding).
+      #
+      # @note This operation can make a static sandbox call.
+      # @param seller_id [String] A selling partner identifier, such as a merchant account or vendor code.
+      # @param sku [String] A selling partner provided identifier for an Amazon listing.
+      # @param marketplace_ids [Array<String>] A comma-delimited list of Amazon marketplace identifiers for the request.
+      # @param included_data [Array<String>] A comma-delimited list of data sets to include in the response. Default:
+      #   `issues`.
+      # @param mode [String] The mode of operation for the request.
+      # @param issue_locale [String] A locale for localization of issues. When not provided, the default language code
+      #   of the first marketplace is used. Examples: `en_US`, `fr_CA`, `fr_FR`. Localized messages default to `en_US`
+      #   when a localization is not available in the specified locale.
+      # @param body [Hash] The request body schema for the `putListingsItem` operation.
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def put_listings_item(seller_id, sku, marketplace_ids, body, included_data: ["issues"], mode: nil,
+        issue_locale: nil, rate_limit: 5.0)
+        path = "/listings/2021-08-01/items/#{seller_id}/#{sku}"
+        params = {
+          "marketplaceIds" => marketplace_ids,
+          "includedData" => included_data,
+          "mode" => mode,
+          "issueLocale" => issue_locale,
+        }.compact
+
+        meter(rate_limit).put(path, body:, params:)
+      end
+    end
+  end
+end

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

@@ -3,24 +3,34 @@
 require "peddler/api"
 
 module Peddler
-  class API
+  class << self
+    def listings_restrictions_2021_08_01(...)
+      APIs::ListingsRestrictions20210801.new(...)
+    end
+  end
+
+  module APIs
     # Selling Partner API for Listings Restrictions
     #
     # The Selling Partner API for Listings Restrictions provides programmatic access to restrictions on Amazon catalog
-    # listings. For more information, see the [Listings Restrictions API Use Case
-    # Guide](doc:listings-restrictions-api-v2021-08-01-use-case-guide).
+    # listings. For more information, see the
+    # {https://developer-docs.amazon.com/sp-api/docs/listings-restrictions-api-v2021-08-01-use-case-guide Listings
+    # Restrictions API Use Case Guide}.
     class ListingsRestrictions20210801 < API
       # Returns listing restrictions for an item in the Amazon Catalog.
       #
-      # @param [String] asin The Amazon Standard Identification Number (ASIN) of the item.
-      # @param [String] condition_type The condition used to filter restrictions.
-      # @param [String] seller_id A selling partner identifier, such as a merchant account.
-      # @param [Array<String>] marketplace_ids A comma-delimited list of Amazon marketplace identifiers for the request.
-      # @param [String] reason_locale A locale for reason text localization. When not provided, the default language
+      # @note This operation can make a static sandbox call.
+      # @param asin [String] The Amazon Standard Identification Number (ASIN) of the item.
+      # @param condition_type [String] The condition used to filter restrictions.
+      # @param seller_id [String] A selling partner identifier, such as a merchant account.
+      # @param marketplace_ids [Array<String>] A comma-delimited list of Amazon marketplace identifiers for the request.
+      # @param reason_locale [String] A locale for reason text localization. When not provided, the default language
       #   code of the first marketplace is used. Examples: "en_US", "fr_CA", "fr_FR". Localized messages default to
       #   "en_US" when a localization is not available in the specified locale.
-      # @return [Hash] The API response
-      def get_listings_restrictions(asin, seller_id, marketplace_ids, condition_type: nil, reason_locale: nil)
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def get_listings_restrictions(asin, seller_id, marketplace_ids, condition_type: nil, reason_locale: nil,
+        rate_limit: 5.0)
         path = "/listings/2021-08-01/restrictions"
         params = {
           "asin" => asin,
@@ -30,7 +40,7 @@ module Peddler
           "reasonLocale" => reason_locale,
         }.compact
 
-        rate_limit(5.0).get(path, params:)
+        meter(rate_limit).get(path, params:)
       end
     end
   end

data/lib/peddler/apis/merchant_fulfillment_v0.rb

@@ -0,0 +1,80 @@
+# frozen_string_literal: true
+
+require "peddler/api"
+
+module Peddler
+  class << self
+    def merchant_fulfillment_v0(...)
+      APIs::MerchantFulfillmentV0.new(...)
+    end
+  end
+
+  module APIs
+    # Selling Partner API for Merchant Fulfillment
+    #
+    # With the Selling Partner API for Merchant Fulfillment, you can build applications that sellers can use to purchase
+    # shipping for non-Prime and Prime orders using Amazon's Buy Shipping Services.
+    class MerchantFulfillmentV0 < API
+      # Returns a list of shipping service offers that satisfy the specified shipment request details.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param body [Hash] The request schema for the `GetEligibleShipmentServices` operation.
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def get_eligible_shipment_services(body, rate_limit: 6.0)
+        path = "/mfn/v0/eligibleShippingServices"
+
+        meter(rate_limit).post(path, body:)
+      end
+
+      # Returns the shipment information for an existing shipment.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param shipment_id [String] The Amazon-defined shipment identifier for the shipment.
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def get_shipment(shipment_id, rate_limit: 1.0)
+        path = "/mfn/v0/shipments/#{shipment_id}"
+
+        meter(rate_limit).get(path)
+      end
+
+      # Cancel the shipment indicated by the specified shipment identifier.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param shipment_id [String] The Amazon-defined shipment identifier for the shipment to cancel.
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def cancel_shipment(shipment_id, rate_limit: 1.0)
+        path = "/mfn/v0/shipments/#{shipment_id}"
+
+        meter(rate_limit).delete(path)
+      end
+
+      # Create a shipment with the information provided.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param body [Hash] The request schema for the `CreateShipment` operation.
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def create_shipment(body, rate_limit: 2.0)
+        path = "/mfn/v0/shipments"
+
+        meter(rate_limit).post(path, body:)
+      end
+
+      # Gets a list of additional seller inputs required for a ship method. This is generally used for international
+      # shipping.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param body [Hash] The request schema for the `GetAdditionalSellerInputs` operation.
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def get_additional_seller_inputs(body, rate_limit: 1.0)
+        path = "/mfn/v0/additionalSellerInputs"
+
+        meter(rate_limit).post(path, body:)
+      end
+    end
+  end
+end

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

@@ -3,7 +3,13 @@
 require "peddler/api"
 
 module Peddler
-  class API
+  class << self
+    def messaging_v1(...)
+      APIs::MessagingV1.new(...)
+    end
+  end
+
+  module APIs
     # Selling Partner API for Messaging
     #
     # With the Messaging API you can build applications that send messages to buyers. You can get a list of message
@@ -15,220 +21,246 @@ module Peddler
       # by an actions object, which contains a path and query parameter(s). You can use the path and parameter(s) to
       # call an operation that sends a message.
       #
-      # @param [String] amazon_order_id An Amazon order identifier. This specifies the order for which you want a list
+      # @note This operation can make a static sandbox call.
+      # @param amazon_order_id [String] An Amazon order identifier. This specifies the order for which you want a list
       #   of available message types.
-      # @param [Array<String>] marketplace_ids A marketplace identifier. This specifies the marketplace in which the
+      # @param marketplace_ids [Array<String>] A marketplace identifier. This specifies the marketplace in which the
       #   order was placed. Only one marketplace can be specified.
-      # @return [Hash] The API response
-      def get_messaging_actions_for_order(amazon_order_id, marketplace_ids)
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def get_messaging_actions_for_order(amazon_order_id, marketplace_ids, rate_limit: 1.0)
         path = "/messaging/v1/orders/#{amazon_order_id}"
         params = {
           "marketplaceIds" => marketplace_ids,
         }.compact
 
-        rate_limit(1.0).get(path, params:)
+        meter(rate_limit).get(path, params:)
       end
 
       # Sends a message asking a buyer to provide or verify customization details such as name spelling, images,
       # initials, etc.
       #
-      # @param [String] amazon_order_id An Amazon order identifier. This specifies the order for which a message is
+      # @note This operation can make a static sandbox call.
+      # @param amazon_order_id [String] An Amazon order identifier. This specifies the order for which a message is
       #   sent.
-      # @param [Array<String>] marketplace_ids A marketplace identifier. This specifies the marketplace in which the
+      # @param marketplace_ids [Array<String>] A marketplace identifier. This specifies the marketplace in which the
       #   order was placed. Only one marketplace can be specified.
-      # @param [Hash] body
-      # @return [Hash] The API response
-      def confirm_customization_details(amazon_order_id, marketplace_ids, body)
+      # @param body [Hash]
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def confirm_customization_details(amazon_order_id, marketplace_ids, body, rate_limit: 1.0)
         path = "/messaging/v1/orders/#{amazon_order_id}/messages/confirmCustomizationDetails"
         params = {
           "marketplaceIds" => marketplace_ids,
         }.compact
 
-        rate_limit(1.0).post(path, body:, params:)
+        meter(rate_limit).post(path, body:, params:)
       end
 
       # Sends a message to a buyer to arrange a delivery or to confirm contact information for making a delivery.
       #
-      # @param [String] amazon_order_id An Amazon order identifier. This specifies the order for which a message is
+      # @note This operation can make a static sandbox call.
+      # @param amazon_order_id [String] An Amazon order identifier. This specifies the order for which a message is
       #   sent.
-      # @param [Array<String>] marketplace_ids A marketplace identifier. This specifies the marketplace in which the
+      # @param marketplace_ids [Array<String>] A marketplace identifier. This specifies the marketplace in which the
       #   order was placed. Only one marketplace can be specified.
-      # @param [Hash] body
-      # @return [Hash] The API response
-      def create_confirm_delivery_details(amazon_order_id, marketplace_ids, body)
+      # @param body [Hash]
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def create_confirm_delivery_details(amazon_order_id, marketplace_ids, body, rate_limit: 1.0)
         path = "/messaging/v1/orders/#{amazon_order_id}/messages/confirmDeliveryDetails"
         params = {
           "marketplaceIds" => marketplace_ids,
         }.compact
 
-        rate_limit(1.0).post(path, body:, params:)
+        meter(rate_limit).post(path, body:, params:)
       end
 
       # Sends a critical message that contains documents that a seller is legally obligated to provide to the buyer.
       # This message should only be used to deliver documents that are required by law.
       #
-      # @param [String] amazon_order_id An Amazon order identifier. This specifies the order for which a message is
+      # @note This operation can make a static sandbox call.
+      # @param amazon_order_id [String] An Amazon order identifier. This specifies the order for which a message is
       #   sent.
-      # @param [Array<String>] marketplace_ids A marketplace identifier. This specifies the marketplace in which the
+      # @param marketplace_ids [Array<String>] A marketplace identifier. This specifies the marketplace in which the
       #   order was placed. Only one marketplace can be specified.
-      # @param [Hash] body
-      # @return [Hash] The API response
-      def create_legal_disclosure(amazon_order_id, marketplace_ids, body)
+      # @param body [Hash]
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def create_legal_disclosure(amazon_order_id, marketplace_ids, body, rate_limit: 1.0)
         path = "/messaging/v1/orders/#{amazon_order_id}/messages/legalDisclosure"
         params = {
           "marketplaceIds" => marketplace_ids,
         }.compact
 
-        rate_limit(1.0).post(path, body:, params:)
+        meter(rate_limit).post(path, body:, params:)
       end
 
       # Sends a non-critical message that asks a buyer to remove their negative feedback. This message should only be
       # sent after the seller has resolved the buyer's problem.
       #
-      # @param [String] amazon_order_id An Amazon order identifier. This specifies the order for which a message is
+      # @note This operation can make a static sandbox call.
+      # @param amazon_order_id [String] An Amazon order identifier. This specifies the order for which a message is
       #   sent.
-      # @param [Array<String>] marketplace_ids A marketplace identifier. This specifies the marketplace in which the
+      # @param marketplace_ids [Array<String>] A marketplace identifier. This specifies the marketplace in which the
       #   order was placed. Only one marketplace can be specified.
-      # @return [Hash] The API response
-      def create_negative_feedback_removal(amazon_order_id, marketplace_ids)
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def create_negative_feedback_removal(amazon_order_id, marketplace_ids, rate_limit: 1.0)
         path = "/messaging/v1/orders/#{amazon_order_id}/messages/negativeFeedbackRemoval"
         params = {
           "marketplaceIds" => marketplace_ids,
         }.compact
 
-        rate_limit(1.0).post(path, params:)
+        meter(rate_limit).post(path, params:)
       end
 
       # Sends a message to ask a buyer an order-related question prior to shipping their order.
       #
-      # @param [String] amazon_order_id An Amazon order identifier. This specifies the order for which a message is
+      # @note This operation can make a static sandbox call.
+      # @param amazon_order_id [String] An Amazon order identifier. This specifies the order for which a message is
       #   sent.
-      # @param [Array<String>] marketplace_ids A marketplace identifier. This specifies the marketplace in which the
+      # @param marketplace_ids [Array<String>] A marketplace identifier. This specifies the marketplace in which the
       #   order was placed. Only one marketplace can be specified.
-      # @param [Hash] body
-      # @return [Hash] The API response
-      def create_confirm_order_details(amazon_order_id, marketplace_ids, body)
+      # @param body [Hash]
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def create_confirm_order_details(amazon_order_id, marketplace_ids, body, rate_limit: 1.0)
         path = "/messaging/v1/orders/#{amazon_order_id}/messages/confirmOrderDetails"
         params = {
           "marketplaceIds" => marketplace_ids,
         }.compact
 
-        rate_limit(1.0).post(path, body:, params:)
+        meter(rate_limit).post(path, body:, params:)
       end
 
       # Sends a message to contact a Home Service customer to arrange a service call or to gather information prior to a
       # service call.
       #
-      # @param [String] amazon_order_id An Amazon order identifier. This specifies the order for which a message is
+      # @note This operation can make a static sandbox call.
+      # @param amazon_order_id [String] An Amazon order identifier. This specifies the order for which a message is
       #   sent.
-      # @param [Array<String>] marketplace_ids A marketplace identifier. This specifies the marketplace in which the
+      # @param marketplace_ids [Array<String>] A marketplace identifier. This specifies the marketplace in which the
       #   order was placed. Only one marketplace can be specified.
-      # @param [Hash] body
-      # @return [Hash] The API response
-      def create_confirm_service_details(amazon_order_id, marketplace_ids, body)
+      # @param body [Hash]
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def create_confirm_service_details(amazon_order_id, marketplace_ids, body, rate_limit: 1.0)
         path = "/messaging/v1/orders/#{amazon_order_id}/messages/confirmServiceDetails"
         params = {
           "marketplaceIds" => marketplace_ids,
         }.compact
 
-        rate_limit(1.0).post(path, body:, params:)
+        meter(rate_limit).post(path, body:, params:)
       end
 
       # Sends a message to a buyer to provide details about an Amazon Motors order. This message can only be sent by
       # Amazon Motors sellers.
       #
-      # @param [String] amazon_order_id An Amazon order identifier. This specifies the order for which a message is
+      # @note This operation can make a static sandbox call.
+      # @param amazon_order_id [String] An Amazon order identifier. This specifies the order for which a message is
       #   sent.
-      # @param [Array<String>] marketplace_ids A marketplace identifier. This specifies the marketplace in which the
+      # @param marketplace_ids [Array<String>] A marketplace identifier. This specifies the marketplace in which the
       #   order was placed. Only one marketplace can be specified.
-      # @param [Hash] body
-      # @return [Hash] The API response
-      def create_amazon_motors(amazon_order_id, marketplace_ids, body)
+      # @param body [Hash]
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def create_amazon_motors(amazon_order_id, marketplace_ids, body, rate_limit: 1.0)
         path = "/messaging/v1/orders/#{amazon_order_id}/messages/amazonMotors"
         params = {
           "marketplaceIds" => marketplace_ids,
         }.compact
 
-        rate_limit(1.0).post(path, body:, params:)
+        meter(rate_limit).post(path, body:, params:)
       end
 
       # Sends a message to a buyer to provide details about warranty information on a purchase in their order.
       #
-      # @param [String] amazon_order_id An Amazon order identifier. This specifies the order for which a message is
+      # @note This operation can make a static sandbox call.
+      # @param amazon_order_id [String] An Amazon order identifier. This specifies the order for which a message is
       #   sent.
-      # @param [Array<String>] marketplace_ids A marketplace identifier. This specifies the marketplace in which the
+      # @param marketplace_ids [Array<String>] A marketplace identifier. This specifies the marketplace in which the
       #   order was placed. Only one marketplace can be specified.
-      # @param [Hash] body
-      # @return [Hash] The API response
-      def create_warranty(amazon_order_id, marketplace_ids, body)
+      # @param body [Hash]
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def create_warranty(amazon_order_id, marketplace_ids, body, rate_limit: 1.0)
         path = "/messaging/v1/orders/#{amazon_order_id}/messages/warranty"
         params = {
           "marketplaceIds" => marketplace_ids,
         }.compact
 
-        rate_limit(1.0).post(path, body:, params:)
+        meter(rate_limit).post(path, body:, params:)
       end
 
       # Returns a response containing attributes related to an order. This includes buyer preferences.
       #
-      # @param [String] amazon_order_id An Amazon order identifier. This specifies the order for which a message is
+      # @note This operation can make a static sandbox call.
+      # @param amazon_order_id [String] An Amazon order identifier. This specifies the order for which a message is
       #   sent.
-      # @param [Array<String>] marketplace_ids A marketplace identifier. This specifies the marketplace in which the
+      # @param marketplace_ids [Array<String>] A marketplace identifier. This specifies the marketplace in which the
       #   order was placed. Only one marketplace can be specified.
-      # @return [Hash] The API response
-      def get_attributes(amazon_order_id, marketplace_ids)
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def get_attributes(amazon_order_id, marketplace_ids, rate_limit: 1.0)
         path = "/messaging/v1/orders/#{amazon_order_id}/attributes"
         params = {
           "marketplaceIds" => marketplace_ids,
         }.compact
 
-        rate_limit(1.0).get(path, params:)
+        meter(rate_limit).get(path, params:)
       end
 
       # Sends a message to a buyer to share a digital access key needed to utilize digital content in their order.
       #
-      # @param [String] amazon_order_id An Amazon order identifier. This specifies the order for which a message is
+      # @note This operation can make a static sandbox call.
+      # @param amazon_order_id [String] An Amazon order identifier. This specifies the order for which a message is
       #   sent.
-      # @param [Array<String>] marketplace_ids A marketplace identifier. This specifies the marketplace in which the
+      # @param marketplace_ids [Array<String>] A marketplace identifier. This specifies the marketplace in which the
       #   order was placed. Only one marketplace can be specified.
-      # @param [Hash] body
-      # @return [Hash] The API response
-      def create_digital_access_key(amazon_order_id, marketplace_ids, body)
+      # @param body [Hash]
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def create_digital_access_key(amazon_order_id, marketplace_ids, body, rate_limit: 1.0)
         path = "/messaging/v1/orders/#{amazon_order_id}/messages/digitalAccessKey"
         params = {
           "marketplaceIds" => marketplace_ids,
         }.compact
 
-        rate_limit(1.0).post(path, body:, params:)
+        meter(rate_limit).post(path, body:, params:)
       end
 
       # Sends a critical message to a buyer that an unexpected problem was encountered affecting the completion of the
       # order.
       #
-      # @param [String] amazon_order_id An Amazon order identifier. This specifies the order for which a message is
+      # @note This operation can make a static sandbox call.
+      # @param amazon_order_id [String] An Amazon order identifier. This specifies the order for which a message is
       #   sent.
-      # @param [Array<String>] marketplace_ids A marketplace identifier. This specifies the marketplace in which the
+      # @param marketplace_ids [Array<String>] A marketplace identifier. This specifies the marketplace in which the
       #   order was placed. Only one marketplace can be specified.
-      # @param [Hash] body
-      # @return [Hash] The API response
-      def create_unexpected_problem(amazon_order_id, marketplace_ids, body)
+      # @param body [Hash]
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def create_unexpected_problem(amazon_order_id, marketplace_ids, body, rate_limit: 1.0)
         path = "/messaging/v1/orders/#{amazon_order_id}/messages/unexpectedProblem"
         params = {
           "marketplaceIds" => marketplace_ids,
         }.compact
 
-        rate_limit(1.0).post(path, body:, params:)
+        meter(rate_limit).post(path, body:, params:)
       end
 
       # Sends a message providing the buyer an invoice
       #
-      # @param [String] amazon_order_id An Amazon order identifier. This specifies the order for which a message is
+      # @note This operation can make a static sandbox call.
+      # @param amazon_order_id [String] An Amazon order identifier. This specifies the order for which a message is
       #   sent.
-      # @param [Array<String>] marketplace_ids A marketplace identifier. This specifies the marketplace in which the
+      # @param marketplace_ids [Array<String>] A marketplace identifier. This specifies the marketplace in which the
       #   order was placed. Only one marketplace can be specified.
-      # @param [Hash] body
-      # @return [Hash] The API response
-      def send_invoice(amazon_order_id, marketplace_ids, body)
+      # @param body [Hash]
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def send_invoice(amazon_order_id, marketplace_ids, body, rate_limit: nil)
         path = "/messaging/v1/orders/#{amazon_order_id}/messages/invoice"
         params = {
           "marketplaceIds" => marketplace_ids,