peddler 3.0.0.beta1 → 4.0.0

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

@@ -3,7 +3,13 @@
 require "peddler/api"
 
 module Peddler
-  class API
+  class << self
+    def shipping_v2(...)
+      APIs::ShippingV2.new(...)
+    end
+  end
+
+  module APIs
     # Amazon Shipping API
     #
     # The Amazon Shipping API is designed to support outbound shipping use cases both for orders originating on
@@ -12,32 +18,38 @@ module Peddler
     class ShippingV2 < API
       # Returns the available shipping service offerings.
       #
-      # @param [Hash] body
-      # @param [String] x_amzn_shipping_business_id Amazon shipping business to assume for this request. The default is
+      # @note This operation can make a dynamic sandbox call.
+      # @param body [Hash]
+      # @param x_amzn_shipping_business_id [String] Amazon shipping business to assume for this request. The default is
       #   AmazonShipping_UK.
-      # @return [Hash] The API response
-      def get_rates(body, x_amzn_shipping_business_id: nil)
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def get_rates(body, x_amzn_shipping_business_id: nil, rate_limit: 80.0)
         path = "/shipping/v2/shipments/rates"
 
-        rate_limit(80.0).post(path, body:)
+        meter(rate_limit).post(path, body:)
       end
 
       # Purchases the shipping service for a shipment using the best fit service offering. Returns purchase related
       # details and documents.
       #
-      # @param [Hash] body
-      # @param [String] x_amzn_idempotency_key A unique value which the server uses to recognize subsequent retries of
+      # @param body [Hash]
+      # @param x_amzn_idempotency_key [String] A unique value which the server uses to recognize subsequent retries of
       #   the same request.
-      # @param [String] locale The IETF Language Tag. Note that this only supports the primary language subtag with one
+      # @param locale [String] The IETF Language Tag. Note that this only supports the primary language subtag with one
       #   secondary language subtag (i.e. en-US, fr-CA). The secondary language subtag is almost always a regional
       #   designation. This does not support additional subtags beyond the primary and secondary language subtags.
-      # @param [String] x_amzn_shipping_business_id Amazon shipping business to assume for this request. The default is
+      # @param x_amzn_shipping_business_id [String] Amazon shipping business to assume for this request. The default is
       #   AmazonShipping_UK.
-      # @return [Hash] The API response
-      def direct_purchase_shipment(body, x_amzn_idempotency_key: nil, locale: nil, x_amzn_shipping_business_id: nil)
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def direct_purchase_shipment(body, x_amzn_idempotency_key: nil, locale: nil, x_amzn_shipping_business_id: nil,
+        rate_limit: 80.0)
+        cannot_sandbox!
+
         path = "/shipping/v2/shipments/directPurchase"
 
-        rate_limit(80.0).post(path, body:)
+        meter(rate_limit).post(path, body:)
       end
 
       # Purchases a shipping service and returns purchase related details and documents. Note: You must complete the
@@ -45,63 +57,71 @@ module Peddler
       # 10 minutes have expired, you will receive an error response with the error code equal to "TOKEN_EXPIRED". If you
       # receive this error response, you must get the rates for the shipment again.
       #
-      # @param [Hash] body
-      # @param [String] x_amzn_idempotency_key A unique value which the server uses to recognize subsequent retries of
+      # @note This operation can make a dynamic sandbox call.
+      # @param body [Hash]
+      # @param x_amzn_idempotency_key [String] A unique value which the server uses to recognize subsequent retries of
       #   the same request.
-      # @param [String] x_amzn_shipping_business_id Amazon shipping business to assume for this request. The default is
+      # @param x_amzn_shipping_business_id [String] Amazon shipping business to assume for this request. The default is
       #   AmazonShipping_UK.
-      # @return [Hash] The API response
-      def purchase_shipment(body, x_amzn_idempotency_key: nil, x_amzn_shipping_business_id: nil)
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def purchase_shipment(body, x_amzn_idempotency_key: nil, x_amzn_shipping_business_id: nil, rate_limit: 80.0)
         path = "/shipping/v2/shipments"
 
-        rate_limit(80.0).post(path, body:)
+        meter(rate_limit).post(path, body:)
       end
 
       # Purchases a shipping service identifier and returns purchase-related details and documents.
       #
-      # @param [Hash] body
-      # @param [String] x_amzn_shipping_business_id Amazon shipping business to assume for this request. The default is
+      # @note This operation can make a dynamic sandbox call.
+      # @param body [Hash]
+      # @param x_amzn_shipping_business_id [String] Amazon shipping business to assume for this request. The default is
       #   AmazonShipping_UK.
-      # @return [Hash] The API response
-      def one_click_shipment(body, x_amzn_shipping_business_id: nil)
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def one_click_shipment(body, x_amzn_shipping_business_id: nil, rate_limit: 80.0)
         path = "/shipping/v2/oneClickShipment"
 
-        rate_limit(80.0).post(path, body:)
+        meter(rate_limit).post(path, body:)
       end
 
       # Returns tracking information for a purchased shipment.
       #
-      # @param [String] tracking_id A carrier-generated tracking identifier originally returned by the purchaseShipment
+      # @note This operation can make a dynamic sandbox call.
+      # @param tracking_id [String] A carrier-generated tracking identifier originally returned by the purchaseShipment
       #   operation.
-      # @param [String] carrier_id A carrier identifier originally returned by the getRates operation for the selected
+      # @param carrier_id [String] A carrier identifier originally returned by the getRates operation for the selected
       #   rate.
-      # @param [String] x_amzn_shipping_business_id Amazon shipping business to assume for this request. The default is
+      # @param x_amzn_shipping_business_id [String] Amazon shipping business to assume for this request. The default is
       #   AmazonShipping_UK.
-      # @return [Hash] The API response
-      def get_tracking(tracking_id, carrier_id, x_amzn_shipping_business_id: nil)
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def get_tracking(tracking_id, carrier_id, x_amzn_shipping_business_id: nil, rate_limit: 80.0)
         path = "/shipping/v2/tracking"
         params = {
           "trackingId" => tracking_id,
           "carrierId" => carrier_id,
         }.compact
 
-        rate_limit(80.0).get(path, params:)
+        meter(rate_limit).get(path, params:)
       end
 
       # Returns the shipping documents associated with a package in a shipment.
       #
-      # @param [String] shipment_id The shipment identifier originally returned by the purchaseShipment operation.
-      # @param [String] package_client_reference_id The package client reference identifier originally provided in the
+      # @note This operation can make a dynamic sandbox call.
+      # @param shipment_id [String] The shipment identifier originally returned by the purchaseShipment operation.
+      # @param package_client_reference_id [String] The package client reference identifier originally provided in the
       #   request body parameter for the getRates operation.
-      # @param [String] format The file format of the document. Must be one of the supported formats returned by the
+      # @param format [String] The file format of the document. Must be one of the supported formats returned by the
       #   getRates operation.
-      # @param [Number] dpi The resolution of the document (for example, 300 means 300 dots per inch). Must be one of
+      # @param dpi [Number] The resolution of the document (for example, 300 means 300 dots per inch). Must be one of
       #   the supported resolutions returned in the response to the getRates operation.
-      # @param [String] x_amzn_shipping_business_id Amazon shipping business to assume for this request. The default is
+      # @param x_amzn_shipping_business_id [String] Amazon shipping business to assume for this request. The default is
       #   AmazonShipping_UK.
-      # @return [Hash] The API response
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
       def get_shipment_documents(shipment_id, package_client_reference_id, format: nil, dpi: nil,
-        x_amzn_shipping_business_id: nil)
+        x_amzn_shipping_business_id: nil, rate_limit: 80.0)
         path = "/shipping/v2/shipments/#{shipment_id}/documents"
         params = {
           "packageClientReferenceId" => package_client_reference_id,
@@ -109,150 +129,182 @@ module Peddler
           "dpi" => dpi,
         }.compact
 
-        rate_limit(80.0).get(path, params:)
+        meter(rate_limit).get(path, params:)
       end
 
       # Cancels a purchased shipment. Returns an empty object if the shipment is successfully cancelled.
       #
-      # @param [String] shipment_id The shipment identifier originally returned by the purchaseShipment operation.
-      # @param [String] x_amzn_shipping_business_id Amazon shipping business to assume for this request. The default is
+      # @note This operation can make a dynamic sandbox call.
+      # @param shipment_id [String] The shipment identifier originally returned by the purchaseShipment operation.
+      # @param x_amzn_shipping_business_id [String] Amazon shipping business to assume for this request. The default is
       #   AmazonShipping_UK.
-      # @return [Hash] The API response
-      def cancel_shipment(shipment_id, x_amzn_shipping_business_id: nil)
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def cancel_shipment(shipment_id, x_amzn_shipping_business_id: nil, rate_limit: 80.0)
         path = "/shipping/v2/shipments/#{shipment_id}/cancel"
 
-        rate_limit(80.0).put(path)
+        meter(rate_limit).put(path)
       end
 
       # Returns the JSON schema to use for providing additional inputs when needed to purchase a shipping offering. Call
       # the getAdditionalInputs operation when the response to a previous call to the getRates operation indicates that
       # additional inputs are required for the rate (shipping offering) that you want to purchase.
       #
-      # @param [String] request_token The request token returned in the response to the getRates operation.
-      # @param [String] rate_id The rate identifier for the shipping offering (rate) returned in the response to the
+      # @note This operation can make a static sandbox call.
+      # @param request_token [String] The request token returned in the response to the getRates operation.
+      # @param rate_id [String] The rate identifier for the shipping offering (rate) returned in the response to the
       #   getRates operation.
-      # @param [String] x_amzn_shipping_business_id Amazon shipping business to assume for this request. The default is
+      # @param x_amzn_shipping_business_id [String] Amazon shipping business to assume for this request. The default is
       #   AmazonShipping_UK.
-      # @return [Hash] The API response
-      def get_additional_inputs(request_token, rate_id, x_amzn_shipping_business_id: nil)
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def get_additional_inputs(request_token, rate_id, x_amzn_shipping_business_id: nil, rate_limit: 80.0)
         path = "/shipping/v2/shipments/additionalInputs/schema"
         params = {
           "requestToken" => request_token,
           "rateId" => rate_id,
         }.compact
 
-        rate_limit(80.0).get(path, params:)
+        meter(rate_limit).get(path, params:)
       end
 
       # This API will return a list of input schema required to register a shipper account with the carrier.
       #
-      # @param [String] x_amzn_shipping_business_id Amazon shipping business to assume for this request. The default is
+      # @param x_amzn_shipping_business_id [String] Amazon shipping business to assume for this request. The default is
       #   AmazonShipping_UK.
-      # @return [Hash] The API response
-      def get_carrier_account_form_inputs(x_amzn_shipping_business_id: nil)
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def get_carrier_account_form_inputs(x_amzn_shipping_business_id: nil, rate_limit: 80.0)
+        cannot_sandbox!
+
         path = "/shipping/v2/carrierAccountFormInputs"
 
-        rate_limit(80.0).get(path)
+        meter(rate_limit).get(path)
       end
 
       # This API will return Get all carrier accounts for a merchant.
       #
-      # @param [Hash] body
-      # @param [String] x_amzn_shipping_business_id Amazon shipping business to assume for this request. The default is
+      # @param body [Hash]
+      # @param x_amzn_shipping_business_id [String] Amazon shipping business to assume for this request. The default is
       #   AmazonShipping_UK.
-      # @return [Hash] The API response
-      def get_carrier_accounts(body, x_amzn_shipping_business_id: nil)
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def get_carrier_accounts(body, x_amzn_shipping_business_id: nil, rate_limit: 80.0)
+        cannot_sandbox!
+
         path = "/shipping/v2/carrierAccounts"
 
-        rate_limit(80.0).put(path, body:)
+        meter(rate_limit).put(path, body:)
       end
 
       # This API associates/links the specified carrier account with the merchant.
       #
-      # @param [String] carrier_id The unique identifier associated with the carrier account.
-      # @param [Hash] body
-      # @param [String] x_amzn_shipping_business_id Amazon shipping business to assume for this request. The default is
+      # @param carrier_id [String] The unique identifier associated with the carrier account.
+      # @param body [Hash]
+      # @param x_amzn_shipping_business_id [String] Amazon shipping business to assume for this request. The default is
       #   AmazonShipping_UK.
-      # @return [Hash] The API response
-      def link_carrier_account(carrier_id, body, x_amzn_shipping_business_id: nil)
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def link_carrier_account(carrier_id, body, x_amzn_shipping_business_id: nil, rate_limit: 80.0)
+        cannot_sandbox!
+
         path = "/shipping/v2/carrierAccounts/#{carrier_id}"
 
-        rate_limit(80.0).put(path, body:)
+        meter(rate_limit).put(path, body:)
       end
 
       # This API Unlink the specified carrier account with the merchant.
       #
-      # @param [String] carrier_id carrier Id to unlink with merchant.
-      # @param [Hash] body
-      # @param [String] x_amzn_shipping_business_id Amazon shipping business to assume for this request. The default is
+      # @param carrier_id [String] carrier Id to unlink with merchant.
+      # @param body [Hash]
+      # @param x_amzn_shipping_business_id [String] Amazon shipping business to assume for this request. The default is
       #   AmazonShipping_UK.
-      # @return [Hash] The API response
-      def unlink_carrier_account(carrier_id, body, x_amzn_shipping_business_id: nil)
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def unlink_carrier_account(carrier_id, body, x_amzn_shipping_business_id: nil, rate_limit: 80.0)
+        cannot_sandbox!
+
         path = "/shipping/v2/carrierAccounts/#{carrier_id}/unlink"
 
-        rate_limit(80.0).put(path, body:)
+        meter(rate_limit).put(path, body:)
       end
 
       # This API Call to generate the collection form.
       #
-      # @param [Hash] body
-      # @param [String] x_amzn_idempotency_key A unique value which the server uses to recognize subsequent retries of
+      # @param body [Hash]
+      # @param x_amzn_idempotency_key [String] A unique value which the server uses to recognize subsequent retries of
       #   the same request.
-      # @param [String] x_amzn_shipping_business_id Amazon shipping business to assume for this request. The default is
+      # @param x_amzn_shipping_business_id [String] Amazon shipping business to assume for this request. The default is
       #   AmazonShipping_UK.
-      # @return [Hash] The API response
-      def generate_collection_form(body, x_amzn_idempotency_key: nil, x_amzn_shipping_business_id: nil)
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def generate_collection_form(body, x_amzn_idempotency_key: nil, x_amzn_shipping_business_id: nil,
+        rate_limit: 80.0)
+        cannot_sandbox!
+
         path = "/shipping/v2/collectionForms"
 
-        rate_limit(80.0).post(path, body:)
+        meter(rate_limit).post(path, body:)
       end
 
       # This API Call to get the history of the previously generated collection forms.
       #
-      # @param [Hash] body
-      # @param [String] x_amzn_shipping_business_id Amazon shipping business to assume for this request. The default is
+      # @param body [Hash]
+      # @param x_amzn_shipping_business_id [String] Amazon shipping business to assume for this request. The default is
       #   AmazonShipping_UK.
-      # @return [Hash] The API response
-      def get_collection_form_history(body, x_amzn_shipping_business_id: nil)
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def get_collection_form_history(body, x_amzn_shipping_business_id: nil, rate_limit: 80.0)
+        cannot_sandbox!
+
         path = "/shipping/v2/collectionForms/history"
 
-        rate_limit(80.0).put(path, body:)
+        meter(rate_limit).put(path, body:)
       end
 
       # This API Get all unmanifested carriers with shipment locations. Any locations which has unmanifested shipments
       # with an eligible carrier for manifesting shall be returned.
       #
-      # @param [Hash] body
-      # @param [String] x_amzn_shipping_business_id Amazon shipping business to assume for this request. The default is
+      # @param body [Hash]
+      # @param x_amzn_shipping_business_id [String] Amazon shipping business to assume for this request. The default is
       #   AmazonShipping_UK.
-      # @return [Hash] The API response
-      def get_unmanifested_shipments(body, x_amzn_shipping_business_id: nil)
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def get_unmanifested_shipments(body, x_amzn_shipping_business_id: nil, rate_limit: 80.0)
+        cannot_sandbox!
+
         path = "/shipping/v2/unmanifestedShipments"
 
-        rate_limit(80.0).put(path, body:)
+        meter(rate_limit).put(path, body:)
       end
 
       # This API reprint a collection form.
       #
-      # @param [String] collection_form_id collection form Id to reprint a collection.
-      # @param [String] x_amzn_shipping_business_id Amazon shipping business to assume for this request. The default is
+      # @param collection_form_id [String] collection form Id to reprint a collection.
+      # @param x_amzn_shipping_business_id [String] Amazon shipping business to assume for this request. The default is
       #   AmazonShipping_UK.
-      # @return [Hash] The API response
-      def get_collection_form(collection_form_id, x_amzn_shipping_business_id: nil)
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def get_collection_form(collection_form_id, x_amzn_shipping_business_id: nil, rate_limit: 80.0)
+        cannot_sandbox!
+
         path = "/shipping/v2/collectionForms/#{collection_form_id}"
 
-        rate_limit(80.0).get(path)
+        meter(rate_limit).get(path)
       end
 
       # Returns a list of access points in proximity of input postal code.
       #
-      # @param [Array<String>] access_point_types
-      # @param [String] country_code
-      # @param [String] postal_code
-      # @param [String] x_amzn_shipping_business_id Amazon shipping business to assume for this request. The default is
+      # @note This operation can make a dynamic sandbox call.
+      # @param access_point_types [Array<String>]
+      # @param country_code [String]
+      # @param postal_code [String]
+      # @param x_amzn_shipping_business_id [String] Amazon shipping business to assume for this request. The default is
       #   AmazonShipping_UK.
-      # @return [Hash] The API response
-      def get_access_points(access_point_types, country_code, postal_code, x_amzn_shipping_business_id: nil)
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def get_access_points(access_point_types, country_code, postal_code, x_amzn_shipping_business_id: nil,
+        rate_limit: 80.0)
         path = "/shipping/v2/accessPoints"
         params = {
           "accessPointTypes" => access_point_types,
@@ -260,7 +312,7 @@ module Peddler
           "postalCode" => postal_code,
         }.compact
 
-        rate_limit(80.0).get(path, params:)
+        meter(rate_limit).get(path, params:)
       end
     end
   end

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

@@ -3,7 +3,13 @@
 require "peddler/api"
 
 module Peddler
-  class API
+  class << self
+    def solicitations_v1(...)
+      APIs::SolicitationsV1.new(...)
+    end
+  end
+
+  module APIs
     # Selling Partner API for Solicitations
     #
     # With the Solicitations API you can build applications that send non-critical solicitations to buyers. You can get
@@ -18,35 +24,39 @@ module Peddler
       # parameter(s) to call an operation that sends a solicitation. Currently only the
       # productReviewAndSellerFeedbackSolicitation solicitation type is available.
       #
-      # @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 solicitation 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_solicitation_actions_for_order(amazon_order_id, marketplace_ids)
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def get_solicitation_actions_for_order(amazon_order_id, marketplace_ids, rate_limit: 1.0)
         path = "/solicitations/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 solicitation to a buyer asking for seller feedback and a product review for the specified order. Send
       # only one productReviewAndSellerFeedback or free form proactive message per order.
       #
-      # @param [String] amazon_order_id An Amazon order identifier. This specifies the order for which a solicitation 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 solicitation 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_product_review_and_seller_feedback_solicitation(amazon_order_id, marketplace_ids)
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def create_product_review_and_seller_feedback_solicitation(amazon_order_id, marketplace_ids, rate_limit: 1.0)
         path = "/solicitations/v1/orders/#{amazon_order_id}/solicitations/productReviewAndSellerFeedback"
         params = {
           "marketplaceIds" => marketplace_ids,
         }.compact
 
-        rate_limit(1.0).post(path, params:)
+        meter(rate_limit).post(path, params:)
       end
     end
   end

data/lib/peddler/apis/supply_sources_2020_07_01.rb

@@ -0,0 +1,100 @@
+# frozen_string_literal: true
+
+require "peddler/api"
+
+module Peddler
+  class << self
+    def supply_sources_2020_07_01(...)
+      APIs::SupplySources20200701.new(...)
+    end
+  end
+
+  module APIs
+    # Selling Partner API for Supply Sources
+    #
+    # Manage configurations and capabilities of seller supply sources.
+    class SupplySources20200701 < API
+      # The path to retrieve paginated supply sources.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param next_page_token [String] The pagination token to retrieve a specific page of results.
+      # @param page_size [Number] The number of supply sources to return per paginated request.
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def get_supply_sources(next_page_token: nil, page_size: 10, rate_limit: nil)
+        path = "/supplySources/2020-07-01/supplySources"
+        params = {
+          "nextPageToken" => next_page_token,
+          "pageSize" => page_size,
+        }.compact
+
+        get(path, params:)
+      end
+
+      # Create a new supply source.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param payload [Hash] A request to create a supply source.
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def create_supply_source(payload, rate_limit: nil)
+        path = "/supplySources/2020-07-01/supplySources"
+        body = payload
+
+        post(path, body:)
+      end
+
+      # Retrieve a supply source.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param supply_source_id [String] The unique identifier of a supply source.
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def get_supply_source(supply_source_id, rate_limit: nil)
+        path = "/supplySources/2020-07-01/supplySources/#{supply_source_id}"
+
+        get(path)
+      end
+
+      # Update the configuration and capabilities of a supply source.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param supply_source_id [String] The unique identitier of a supply source.
+      # @param payload [Hash]
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def update_supply_source(supply_source_id, payload: nil, rate_limit: nil)
+        path = "/supplySources/2020-07-01/supplySources/#{supply_source_id}"
+        body = payload
+
+        put(path, body:)
+      end
+
+      # Archive a supply source, making it inactive. Cannot be undone.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param supply_source_id [String] The unique identifier of a supply source.
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def archive_supply_source(supply_source_id, rate_limit: nil)
+        path = "/supplySources/2020-07-01/supplySources/#{supply_source_id}"
+
+        delete(path)
+      end
+
+      # Update the status of a supply source.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param supply_source_id [String] The unique identifier of a supply source.
+      # @param payload [Hash]
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def update_supply_source_status(supply_source_id, payload: nil, rate_limit: nil)
+        path = "/supplySources/2020-07-01/supplySources/#{supply_source_id}/status"
+        body = payload
+
+        put(path, body:)
+      end
+    end
+  end
+end

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

@@ -3,14 +3,20 @@
 require "peddler/api"
 
 module Peddler
-  class API
+  class << self
+    def tokens_2021_03_01(...)
+      APIs::Tokens20210301.new(...)
+    end
+  end
+
+  module APIs
     # Selling Partner API for Tokens
     #
     # The Selling Partner API for Tokens provides a secure way to access a customer's PII (Personally Identifiable
     # Information). You can call the Tokens API to get a Restricted Data Token (RDT) for one or more restricted
     # resources that you specify. The RDT authorizes subsequent calls to restricted operations that correspond to the
-    # restricted resources that you specified. For more information, see the [Tokens API Use Case
-    # Guide](doc:tokens-api-use-case-guide).
+    # restricted resources that you specified. For more information, see the
+    # {https://developer-docs.amazon.com/sp-api/docs/tokens-api-use-case-guide Tokens API Use Case Guide}.
     class Tokens20210301 < API
       # Returns a Restricted Data Token (RDT) for one or more restricted resources that you specify. A restricted
       # resource is the HTTP method and path from a restricted operation that returns Personally Identifiable
@@ -18,12 +24,14 @@ module Peddler
       # Case Guide for a list of restricted operations. Use the RDT returned here as the access token in subsequent
       # calls to the corresponding restricted operations.
       #
-      # @param [Hash] body The restricted data token request details.
-      # @return [Hash] The API response
-      def create_restricted_data_token(body)
+      # @note This operation can make a static sandbox call.
+      # @param body [Hash] The restricted data token request details.
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def create_restricted_data_token(body, rate_limit: 1.0)
         path = "/tokens/2021-03-01/restrictedDataToken"
 
-        rate_limit(1.0).post(path, body:)
+        meter(rate_limit).post(path, body:)
       end
     end
   end