peddler 3.0.0.beta1 → 4.0.0

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

@@ -3,42 +3,50 @@
 require "peddler/api"
 
 module Peddler
-  class API
-    # Selling Partner API for Catalog Items
+  class << self
+    def catalog_items_2022_04_01(...)
+      APIs::CatalogItems20220401.new(...)
+    end
+  end
+
+  module APIs
+    # Catalog Items v2022-04-01
     #
     # The Selling Partner API for Catalog Items provides programmatic access to information about items in the Amazon
-    # catalog. For more information, refer to the [Catalog Items API Use Case
-    # Guide](doc:catalog-items-api-v2022-04-01-use-case-guide).
+    # catalog. For more information, refer to the
+    # {https://developer-docs.amazon.com/sp-api/docs/catalog-items-api-v2022-04-01-use-case-guide Catalog Items API Use
+    # Case Guide}.
     class CatalogItems20220401 < API
       # Search for and return a list of Amazon catalog items and associated information either by identifier or by
       # keywords.
       #
-      # @param [Array<String>] identifiers A comma-delimited list of product identifiers to search the Amazon catalog
+      # @note This operation can make a static sandbox call.
+      # @param identifiers [Array<String>] A comma-delimited list of product identifiers to search the Amazon catalog
       #   for. **Note:** Cannot be used with `keywords`.
-      # @param [String] identifiers_type Type of product identifiers to search the Amazon catalog for. **Note:**
+      # @param identifiers_type [String] Type of product identifiers to search the Amazon catalog for. **Note:**
       #   Required when `identifiers` are provided.
-      # @param [Array<String>] marketplace_ids A comma-delimited list of Amazon marketplace identifiers for the request.
-      # @param [Array<String>] included_data A comma-delimited list of data sets to include in the response. Default:
+      # @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:
       #   `summaries`.
-      # @param [String] locale Locale for retrieving localized summaries. Defaults to the primary locale of the
+      # @param locale [String] Locale for retrieving localized summaries. Defaults to the primary locale of the
       #   marketplace.
-      # @param [String] seller_id A selling partner identifier, such as a seller account or vendor code. **Note:**
+      # @param seller_id [String] A selling partner identifier, such as a seller account or vendor code. **Note:**
       #   Required when `identifiersType` is `SKU`.
-      # @param [Array<String>] keywords A comma-delimited list of words to search the Amazon catalog for. **Note:**
+      # @param keywords [Array<String>] A comma-delimited list of words to search the Amazon catalog for. **Note:**
       #   Cannot be used with `identifiers`.
-      # @param [Array<String>] brand_names A comma-delimited list of brand names to limit the search for
+      # @param brand_names [Array<String>] A comma-delimited list of brand names to limit the search for
       #   `keywords`-based queries. **Note:** Cannot be used with `identifiers`.
-      # @param [Array<String>] classification_ids A comma-delimited list of classification identifiers to limit the
+      # @param classification_ids [Array<String>] A comma-delimited list of classification identifiers to limit the
       #   search for `keywords`-based queries. **Note:** Cannot be used with `identifiers`.
-      # @param [Integer] page_size Number of results to be returned per page.
-      # @param [String] page_token A token to fetch a certain page when there are multiple pages worth of results.
-      # @param [String] keywords_locale The language of the keywords provided for `keywords`-based queries. Defaults to
+      # @param page_size [Integer] Number of results to be returned per page.
+      # @param page_token [String] A token to fetch a certain page when there are multiple pages worth of results.
+      # @param keywords_locale [String] The language of the keywords provided for `keywords`-based queries. Defaults to
       #   the primary locale of the marketplace. **Note:** Cannot be used with `identifiers`.
-      # @return [Hash] The API response
-      def search_catalog_items(
-        marketplace_ids, identifiers: nil, identifiers_type: nil, included_data: nil, locale: nil, seller_id: nil,
-        keywords: nil, brand_names: nil, classification_ids: nil, page_size: nil, page_token: nil, keywords_locale: nil
-      )
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def search_catalog_items(marketplace_ids, identifiers: nil, identifiers_type: nil, included_data: ["summaries"],
+        locale: nil, seller_id: nil, keywords: nil, brand_names: nil, classification_ids: nil, page_size: 10,
+        page_token: nil, keywords_locale: nil, rate_limit: 2.0)
         path = "/catalog/2022-04-01/items"
         params = {
           "identifiers" => identifiers,
@@ -55,20 +63,22 @@ module Peddler
           "keywordsLocale" => keywords_locale,
         }.compact
 
-        rate_limit(2.0).get(path, params:)
+        meter(rate_limit).get(path, params:)
       end
 
       # Retrieves details for an item in the Amazon catalog.
       #
-      # @param [String] asin The Amazon Standard Identification Number (ASIN) of the item.
-      # @param [Array<String>] marketplace_ids A comma-delimited list of Amazon marketplace identifiers. Data sets in
+      # @note This operation can make a static sandbox call.
+      # @param asin [String] The Amazon Standard Identification Number (ASIN) of the item.
+      # @param marketplace_ids [Array<String>] A comma-delimited list of Amazon marketplace identifiers. Data sets in
       #   the response contain data only for the specified marketplaces.
-      # @param [Array<String>] included_data A comma-delimited list of data sets to include in the response. Default:
+      # @param included_data [Array<String>] A comma-delimited list of data sets to include in the response. Default:
       #   `summaries`.
-      # @param [String] locale Locale for retrieving localized summaries. Defaults to the primary locale of the
+      # @param locale [String] Locale for retrieving localized summaries. Defaults to the primary locale of the
       #   marketplace.
-      # @return [Hash] The API response
-      def get_catalog_item(asin, marketplace_ids, included_data: nil, locale: nil)
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def get_catalog_item(asin, marketplace_ids, included_data: ["summaries"], locale: nil, rate_limit: 2.0)
         path = "/catalog/2022-04-01/items/#{asin}"
         params = {
           "marketplaceIds" => marketplace_ids,
@@ -76,7 +86,7 @@ module Peddler
           "locale" => locale,
         }.compact
 
-        rate_limit(2.0).get(path, params:)
+        meter(rate_limit).get(path, params:)
       end
     end
   end

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

@@ -3,7 +3,13 @@
 require "peddler/api"
 
 module Peddler
-  class API
+  class << self
+    def catalog_items_v0(...)
+      APIs::CatalogItemsV0.new(...)
+    end
+  end
+
+  module APIs
     # Selling Partner API for Catalog Items
     #
     # The Selling Partner API for Catalog Items helps you programmatically retrieve item details for items in the
@@ -11,29 +17,32 @@ module Peddler
     class CatalogItemsV0 < API
       # Effective September 30, 2022, the `listCatalogItems` operation will no longer be available in the Selling
       # Partner API for Catalog Items v0. As an alternative, `searchCatalogItems` is available in the latest version of
-      # the [Selling Partner API for Catalog Items v2022-04-01](doc:catalog-items-api-v2022-04-01-reference).
-      # Integrations that rely on the `listCatalogItems` operation should migrate to the `searchCatalogItems`operation
-      # to avoid service disruption. _Note:_ The [`listCatalogCategories`](#get-catalogv0categories) operation is not
-      # being deprecated and you can continue to make calls to it.
+      # the {https://developer-docs.amazon.com/sp-api/docs/catalog-items-api-v2022-04-01-reference Selling Partner API
+      # for Catalog Items v2022-04-01}. Integrations that rely on the `listCatalogItems` operation should migrate to the
+      # `searchCatalogItems`operation to avoid service disruption. _Note:_ The
+      # [`listCatalogCategories`](#get-catalogv0categories) operation is not being deprecated and you can continue to
+      # make calls to it.
       #
-      # @param [String] marketplace_id A marketplace identifier. Specifies the marketplace for which items are returned.
-      # @param [String] query Keyword(s) to use to search for items in the catalog. Example: 'harry potter books'.
-      # @param [String] query_context_id An identifier for the context within which the given search will be performed.
+      # @note This operation can make a static sandbox call.
+      # @param marketplace_id [String] A marketplace identifier. Specifies the marketplace for which items are returned.
+      # @param query [String] Keyword(s) to use to search for items in the catalog. Example: 'harry potter books'.
+      # @param query_context_id [String] An identifier for the context within which the given search will be performed.
       #   A marketplace might provide mechanisms for constraining a search to a subset of potential items. For example,
       #   the retail marketplace allows queries to be constrained to a specific category. The QueryContextId parameter
       #   specifies such a subset. If it is omitted, the search will be performed using the default context for the
       #   marketplace, which will typically contain the largest set of items.
-      # @param [String] seller_sku Used to identify an item in the given marketplace. SellerSKU is qualified by the
+      # @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 [String] upc A 12-digit bar code used for retail packaging.
-      # @param [String] ean A European article number that uniquely identifies the catalog item, manufacturer, and its
+      # @param upc [String] A 12-digit bar code used for retail packaging.
+      # @param ean [String] A European article number that uniquely identifies the catalog item, manufacturer, and its
       #   attributes.
-      # @param [String] isbn The unique commercial book identifier used to identify books internationally.
-      # @param [String] jan A Japanese article number that uniquely identifies the product, manufacturer, and its
+      # @param isbn [String] The unique commercial book identifier used to identify books internationally.
+      # @param jan [String] A Japanese article number that uniquely identifies the product, manufacturer, and its
       #   attributes.
-      # @return [Hash] The API response
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
       def list_catalog_items(marketplace_id, query: nil, query_context_id: nil, seller_sku: nil, upc: nil, ean: nil,
-        isbn: nil, jan: nil)
+        isbn: nil, jan: nil, rate_limit: nil)
         path = "/catalog/v0/items"
         params = {
           "MarketplaceId" => marketplace_id,
@@ -50,16 +59,18 @@ module Peddler
       end
 
       # Effective September 30, 2022, the `getCatalogItem` operation will no longer be available in the Selling Partner
-      # API for Catalog Items v0. This operation is available in the latest version of the [Selling Partner API for
-      # Catalog Items v2022-04-01](doc:catalog-items-api-v2022-04-01-reference). Integrations that rely on this
-      # operation should migrate to the latest version to avoid service disruption. _Note:_ The
-      # [`listCatalogCategories`](#get-catalogv0categories) operation is not being deprecated and you can continue to
-      # make calls to it.
+      # API for Catalog Items v0. This operation is available in the latest version of the
+      # {https://developer-docs.amazon.com/sp-api/docs/catalog-items-api-v2022-04-01-reference Selling Partner API for
+      # Catalog Items v2022-04-01}. Integrations that rely on this operation should migrate to the latest version to
+      # avoid service disruption. _Note:_ The [`listCatalogCategories`](#get-catalogv0categories) operation is not being
+      # deprecated and you can continue to make calls to it.
       #
-      # @param [String] marketplace_id A marketplace identifier. Specifies the marketplace for the item.
-      # @param [String] asin The Amazon Standard Identification Number (ASIN) of the item.
-      # @return [Hash] The API response
-      def get_catalog_item(marketplace_id, asin)
+      # @note This operation can make a static sandbox call.
+      # @param marketplace_id [String] A marketplace identifier. Specifies the marketplace for the item.
+      # @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_catalog_item(marketplace_id, asin, rate_limit: nil)
         path = "/catalog/v0/items/#{asin}"
         params = {
           "MarketplaceId" => marketplace_id,
@@ -70,12 +81,14 @@ module Peddler
 
       # Returns the parent categories to which an item belongs, based on the specified ASIN or SellerSKU.
       #
-      # @param [String] marketplace_id A marketplace identifier. Specifies the marketplace for the item.
-      # @param [String] asin The Amazon Standard Identification Number (ASIN) of the item.
-      # @param [String] seller_sku Used to identify items in the given marketplace. SellerSKU is qualified by the
+      # @note This operation can make a static sandbox call.
+      # @param marketplace_id [String] A marketplace identifier. Specifies the marketplace for the item.
+      # @param asin [String] The Amazon Standard Identification Number (ASIN) of the item.
+      # @param seller_sku [String] Used to identify items in the given marketplace. SellerSKU is qualified by the
       #   seller's SellerId, which is included with every operation that you submit.
-      # @return [Hash] The API response
-      def list_catalog_categories(marketplace_id, asin: nil, seller_sku: nil)
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def list_catalog_categories(marketplace_id, asin: nil, seller_sku: nil, rate_limit: 1.0)
         path = "/catalog/v0/categories"
         params = {
           "MarketplaceId" => marketplace_id,
@@ -83,7 +96,7 @@ module Peddler
           "SellerSKU" => seller_sku,
         }.compact
 
-        rate_limit(1.0).get(path, params:)
+        meter(rate_limit).get(path, params:)
       end
     end
   end

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

@@ -3,7 +3,13 @@
 require "peddler/api"
 
 module Peddler
-  class API
+  class << self
+    def data_kiosk_2023_11_15(...)
+      APIs::DataKiosk20231115.new(...)
+    end
+  end
+
+  module APIs
     # Selling Partner API for Data Kiosk
     #
     # The Selling Partner API for Data Kiosk lets you submit GraphQL queries from a variety of schemas to help selling
@@ -12,20 +18,22 @@ module Peddler
       # Returns details for the Data Kiosk queries that match the specified filters. See the `createQuery` operation for
       # details about query retention.
       #
-      # @param [Array<String>] processing_statuses A list of processing statuses used to filter queries.
-      # @param [Integer] page_size The maximum number of queries to return in a single call.
-      # @param [String] created_since The earliest query creation date and time for queries to include in the response,
+      # @note This operation can make a static sandbox call.
+      # @param processing_statuses [Array<String>] A list of processing statuses used to filter queries.
+      # @param page_size [Integer] The maximum number of queries to return in a single call.
+      # @param created_since [String] The earliest query creation date and time for queries to include in the response,
       #   in ISO 8601 date time format. The default is 90 days ago.
-      # @param [String] created_until The latest query creation date and time for queries to include in the response, in
+      # @param created_until [String] The latest query creation date and time for queries to include in the response, in
       #   ISO 8601 date time format. The default is the time of the `getQueries` request.
-      # @param [String] pagination_token A token to fetch a certain page of results when there are multiple pages of
+      # @param pagination_token [String] A token to fetch a certain page of results when there are multiple pages of
       #   results available. The value of this token is fetched from the `pagination.nextToken` field returned in the
       #   `GetQueriesResponse` object. All other parameters must be provided with the same values that were provided
       #   with the request that generated this token, with the exception of `pageSize` which can be modified between
       #   calls to `getQueries`. In the absence of this token value, `getQueries` returns the first page of results.
-      # @return [Hash] The API response
-      def get_queries(processing_statuses: nil, page_size: nil, created_since: nil, created_until: nil,
-        pagination_token: nil)
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def get_queries(processing_statuses: nil, page_size: 10, created_since: nil, created_until: nil,
+        pagination_token: nil, rate_limit: 0.0222)
         path = "/dataKiosk/2023-11-15/queries"
         params = {
           "processingStatuses" => processing_statuses,
@@ -35,21 +43,23 @@ module Peddler
           "paginationToken" => pagination_token,
         }.compact
 
-        rate_limit(0.0222).get(path, params:)
+        meter(rate_limit).get(path, params:)
       end
 
-      # Creates a Data Kiosk query request.
-      # @note The retention of a query varies based on the fields requested. Each field within a schema is annotated
-      #   with a `@resultRetention` directive that defines how long a query containing that field will be retained. When
-      #   a query contains multiple fields with different retentions, the shortest (minimum) retention is applied. The
-      #   retention of a query's resulting documents always matches the retention of the query.
+      # Creates a Data Kiosk query request. **Note:** The retention of a query varies based on the fields requested.
+      # Each field within a schema is annotated with a `@resultRetention` directive that defines how long a query
+      # containing that field will be retained. When a query contains multiple fields with different retentions, the
+      # shortest (minimum) retention is applied. The retention of a query's resulting documents always matches the
+      # retention of the query.
       #
-      # @param [Hash] body The body of the request.
-      # @return [Hash] The API response
-      def create_query(body)
+      # @note This operation can make a static sandbox call.
+      # @param body [Hash] The body of the request.
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def create_query(body, rate_limit: 0.0167)
         path = "/dataKiosk/2023-11-15/queries"
 
-        rate_limit(0.0167).post(path, body:)
+        meter(rate_limit).post(path, body:)
       end
 
       # Cancels the query specified by the `queryId` parameter. Only queries with a non-terminal `processingStatus`
@@ -57,35 +67,41 @@ module Peddler
       # `CANCELLED` will no-op. Cancelled queries are returned in subsequent calls to the `getQuery` and `getQueries`
       # operations.
       #
-      # @param [String] query_id The identifier for the query. This identifier is unique only in combination with a
+      # @note This operation can make a static sandbox call.
+      # @param query_id [String] The identifier for the query. This identifier is unique only in combination with a
       #   selling partner account ID.
-      # @return [Hash] The API response
-      def cancel_query(query_id)
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def cancel_query(query_id, rate_limit: 0.0222)
         path = "/dataKiosk/2023-11-15/queries/#{query_id}"
 
-        rate_limit(0.0222).delete(path)
+        meter(rate_limit).delete(path)
       end
 
       # Returns query details for the query specified by the `queryId` parameter. See the `createQuery` operation for
       # details about query retention.
       #
-      # @param [String] query_id The query identifier.
-      # @return [Hash] The API response
-      def get_query(query_id)
+      # @note This operation can make a static sandbox call.
+      # @param query_id [String] The query identifier.
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def get_query(query_id, rate_limit: 2.0)
         path = "/dataKiosk/2023-11-15/queries/#{query_id}"
 
-        rate_limit(2.0).get(path)
+        meter(rate_limit).get(path)
       end
 
       # Returns the information required for retrieving a Data Kiosk document's contents. See the `createQuery`
       # operation for details about document retention.
       #
-      # @param [String] document_id The identifier for the Data Kiosk document.
-      # @return [Hash] The API response
-      def get_document(document_id)
+      # @note This operation can make a static sandbox call.
+      # @param document_id [String] The identifier for the Data Kiosk document.
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def get_document(document_id, rate_limit: 0.0167)
         path = "/dataKiosk/2023-11-15/documents/#{document_id}"
 
-        rate_limit(0.0167).get(path)
+        meter(rate_limit).get(path)
       end
     end
   end

data/lib/peddler/apis/easy_ship_2022_03_23.rb

@@ -0,0 +1,126 @@
+# frozen_string_literal: true
+
+require "peddler/api"
+
+module Peddler
+  class << self
+    def easy_ship_2022_03_23(...)
+      APIs::EasyShip20220323.new(...)
+    end
+  end
+
+  module APIs
+    # Selling Partner API for Easy Ship
+    #
+    # The Selling Partner API for Easy Ship helps you build applications that help sellers manage and ship Amazon Easy
+    # Ship orders. Your Easy Ship applications can: * Get available time slots for packages to be scheduled for
+    # delivery. * Schedule, reschedule, and cancel Easy Ship orders. * Print labels, invoices, and warranties. See the
+    # {https://developer-docs.amazon.com/sp-api/docs/easyship-api-v2022-03-23-use-case-guide#marketplace-support-table
+    # Marketplace Support Table} for the differences in Easy Ship operations by marketplace.
+    class EasyShip20220323 < API
+      # Returns time slots available for Easy Ship orders to be scheduled based on the package weight and dimensions
+      # that the seller specifies. This operation is available for scheduled and unscheduled orders based on marketplace
+      # support. See **Get Time Slots** in the
+      # {https://developer-docs.amazon.com/sp-api/docs/easyship-api-v2022-03-23-use-case-guide#marketplace-support-table
+      # Marketplace Support Table}. This operation can return time slots that have either pickup or drop-off handover
+      # methods - see **Supported Handover Methods** in the
+      # {https://developer-docs.amazon.com/sp-api/docs/easyship-api-v2022-03-23-use-case-guide#marketplace-support-table
+      # Marketplace Support Table}.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param list_handover_slots_request [Hash] The request schema for the `listHandoverSlots` operation.
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def list_handover_slots(list_handover_slots_request: nil, rate_limit: 1.0)
+        path = "/easyShip/2022-03-23/timeSlot"
+        body = list_handover_slots_request
+
+        meter(rate_limit).post(path, body:)
+      end
+
+      # Returns information about a package, including dimensions, weight, time slot information for handover, invoice
+      # and item information, and status.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param amazon_order_id [String] An Amazon-defined order identifier. Identifies the order that the seller wants
+      #   to deliver using Amazon Easy Ship.
+      # @param marketplace_id [String] An identifier for the marketplace in which the seller is selling.
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def get_scheduled_package(amazon_order_id, marketplace_id, rate_limit: 1.0)
+        path = "/easyShip/2022-03-23/package"
+        params = {
+          "amazonOrderId" => amazon_order_id,
+          "marketplaceId" => marketplace_id,
+        }.compact
+
+        meter(rate_limit).get(path, params:)
+      end
+
+      # Schedules an Easy Ship order and returns the scheduled package information. This operation does the following: *
+      # Specifies the time slot and handover method for the order to be scheduled for delivery. * Updates the Easy Ship
+      # order status. * Generates a shipping label and an invoice. Calling `createScheduledPackage` also generates a
+      # warranty document if you specify a `SerialNumber` value. To get these documents, see
+      # {https://developer-docs.amazon.com/sp-api/docs/easyship-api-v2022-03-23-use-case-guide How to get invoice,
+      # shipping label, and warranty documents}. * Shows the status of Easy Ship orders when you call the `getOrders`
+      # operation of the Selling Partner API for Orders and examine the `EasyShipShipmentStatus` property in the
+      # response body. See the **Shipping Label**, **Invoice**, and **Warranty** columns in the
+      # {https://developer-docs.amazon.com/sp-api/docs/easyship-api-v2022-03-23-use-case-guide#marketplace-support-table
+      # Marketplace Support Table} to see which documents are supported in each marketplace.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param create_scheduled_package_request [Hash] The request schema for the `createScheduledPackage` operation.
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def create_scheduled_package(create_scheduled_package_request, rate_limit: 1.0)
+        path = "/easyShip/2022-03-23/package"
+        body = create_scheduled_package_request
+
+        meter(rate_limit).post(path, body:)
+      end
+
+      # Updates the time slot for handing over the package indicated by the specified `scheduledPackageId`. You can get
+      # the new `slotId` value for the time slot by calling the `listHandoverSlots` operation before making another
+      # `patch` call. See the **Update Package** column in the
+      # {https://developer-docs.amazon.com/sp-api/docs/easyship-api-v2022-03-23-use-case-guide#marketplace-support-table
+      # Marketplace Support Table} to see which marketplaces this operation is supported in.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param update_scheduled_packages_request [Hash] The request schema for the `updateScheduledPackages` operation.
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def update_scheduled_packages(update_scheduled_packages_request: nil, rate_limit: 1.0)
+        path = "/easyShip/2022-03-23/package"
+        body = update_scheduled_packages_request
+
+        meter(rate_limit).patch(path, body:)
+      end
+
+      # This operation automatically schedules a time slot for all specified `amazonOrderId` values and generates the
+      # associated shipping labels and compliance documents based on the marketplace. For more information, refer to the
+      # [marketplace support
+      # table](https://developer-docs.amazon.com/sp-api/docs/easyship-api-v2022-03-23-use-case-guide#marketplace-support-table).
+      # You can optionally assign a `packageDetails` object to input a preferred time slot for each order in your
+      # request. In such cases, Amazon schedules the respective packages using the specified optional settings. If you
+      # don't specify a time slot, Amazon assigns the earliest available time slot. You can choose PDF or ZPL for your
+      # shipping label's file format and Amazon creates the label accordingly. This operation returns an array that
+      # contains the scheduled packages, and a temporary URL that you can use to access a ZIP file. The ZIP file
+      # includes the generated shipping labels and any other documents that are required for your marketplace. If an
+      # order can't be scheduled, Amazon adds the `rejectedOrders` list in the response. The response contains an entry
+      # for each order that could not be processed. Each entry contains an error message that describes the reason for
+      # the failure. The following table contains the supported request and burst maximum rates:
+      #
+      # @note This operation can make a static sandbox call.
+      # @param create_scheduled_packages_request [Hash] The request schema for the `createScheduledPackageBulk`
+      #   operation.
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def create_scheduled_package_bulk(create_scheduled_packages_request, rate_limit: 1.0)
+        path = "/easyShip/2022-03-23/packages/bulk"
+        body = create_scheduled_packages_request
+
+        meter(rate_limit).post(path, body:)
+      end
+    end
+  end
+end

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

@@ -3,7 +3,13 @@
 require "peddler/api"
 
 module Peddler
-  class API
+  class << self
+    def fba_inbound_eligibility_v1(...)
+      APIs::FBAInboundEligibilityV1.new(...)
+    end
+  end
+
+  module APIs
     # Selling Partner API for FBA Inbound Eligibilty
     #
     # With the FBA Inbound Eligibility API, you can build applications that let sellers get eligibility previews for
@@ -16,12 +22,14 @@ module Peddler
       # preview that you want (INBOUND or COMMINGLING). For INBOUND previews, you can specify the marketplace in which
       # you want to determine the item's eligibility.
       #
-      # @param [Array<String>] marketplace_ids The identifier for the marketplace in which you want to determine
+      # @note This operation can make a static sandbox call.
+      # @param marketplace_ids [Array<String>] The identifier for the marketplace in which you want to determine
       #   eligibility. Required only when program=INBOUND.
-      # @param [String] asin The ASIN of the item for which you want an eligibility preview.
-      # @param [String] program The program that you want to check eligibility against.
-      # @return [Hash] The API response
-      def get_item_eligibility_preview(asin, program, marketplace_ids: nil)
+      # @param asin [String] The ASIN of the item for which you want an eligibility preview.
+      # @param program [String] The program that you want to check eligibility against.
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def get_item_eligibility_preview(asin, program, marketplace_ids: nil, rate_limit: 1.0)
         path = "/fba/inbound/v1/eligibility/itemPreview"
         params = {
           "marketplaceIds" => marketplace_ids,
@@ -29,7 +37,7 @@ module Peddler
           "program" => program,
         }.compact
 
-        rate_limit(1.0).get(path, params:)
+        meter(rate_limit).get(path, params:)
       end
     end
   end