peddler 3.0.0.beta1 → 4.0.0

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

@@ -3,7 +3,13 @@
 require "peddler/api"
 
 module Peddler
-  class API
+  class << self
+    def fulfillment_outbound_2020_07_01(...)
+      APIs::FulfillmentOutbound20200701.new(...)
+    end
+  end
+
+  module APIs
     # Selling Partner APIs for Fulfillment Outbound
     #
     # The Selling Partner API for Fulfillment Outbound lets you create applications that help a seller fulfill
@@ -12,82 +18,95 @@ module Peddler
     class FulfillmentOutbound20200701 < API
       # Returns a list of fulfillment order previews based on shipping criteria that you specify.
       #
-      # @param [Hash] body GetFulfillmentPreviewRequest parameter
-      # @return [Hash] The API response
-      def get_fulfillment_preview(body)
+      # @note This operation can make a dynamic sandbox call.
+      # @param body [Hash] GetFulfillmentPreviewRequest parameter
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def get_fulfillment_preview(body, rate_limit: 2.0)
         path = "/fba/outbound/2020-07-01/fulfillmentOrders/preview"
 
-        rate_limit(2.0).post(path, body:)
+        meter(rate_limit).post(path, body:)
       end
 
       # Returns delivery options that include an estimated delivery date and offer expiration, based on criteria that
       # you specify.
       #
-      # @param [Hash] body GetDeliveryOffersRequest parameter
-      # @return [Hash] The API response
-      def delivery_offers(body)
+      # @note This operation can make a dynamic sandbox call.
+      # @param body [Hash] GetDeliveryOffersRequest parameter
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def delivery_offers(body, rate_limit: 5.0)
         path = "/fba/outbound/2020-07-01/deliveryOffers"
 
-        rate_limit(5.0).post(path, body:)
+        meter(rate_limit).post(path, body:)
       end
 
       # Returns a list of fulfillment orders fulfilled after (or at) a specified date-time, or indicated by the next
       # token parameter.
       #
-      # @param [String] query_start_date A date used to select fulfillment orders that were last updated after (or at) a
+      # @note This operation can make a dynamic sandbox call.
+      # @param query_start_date [String] A date used to select fulfillment orders that were last updated after (or at) a
       #   specified time. An update is defined as any change in fulfillment order status, including the creation of a
       #   new fulfillment order.
-      # @param [String] next_token A string token returned in the response to your previous request.
-      # @return [Hash] The API response
-      def list_all_fulfillment_orders(query_start_date: nil, next_token: nil)
+      # @param next_token [String] A string token returned in the response to your previous request.
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def list_all_fulfillment_orders(query_start_date: nil, next_token: nil, rate_limit: 2.0)
         path = "/fba/outbound/2020-07-01/fulfillmentOrders"
         params = {
           "queryStartDate" => query_start_date,
           "nextToken" => next_token,
         }.compact
 
-        rate_limit(2.0).get(path, params:)
+        meter(rate_limit).get(path, params:)
       end
 
       # Requests that Amazon ship items from the seller's inventory in Amazon's fulfillment network to a destination
       # address.
       #
-      # @param [Hash] body CreateFulfillmentOrderRequest parameter
-      # @return [Hash] The API response
-      def create_fulfillment_order(body)
+      # @note This operation can make a dynamic sandbox call.
+      # @param body [Hash] CreateFulfillmentOrderRequest parameter
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def create_fulfillment_order(body, rate_limit: 2.0)
         path = "/fba/outbound/2020-07-01/fulfillmentOrders"
 
-        rate_limit(2.0).post(path, body:)
+        meter(rate_limit).post(path, body:)
       end
 
       # Returns delivery tracking information for a package in an outbound shipment for a Multi-Channel Fulfillment
       # order.
       #
-      # @param [Integer] package_number The unencrypted package identifier returned by the `getFulfillmentOrder`
+      # @note This operation can make a dynamic sandbox call.
+      # @param package_number [Integer] The unencrypted package identifier returned by the `getFulfillmentOrder`
       #   operation.
-      # @return [Hash] The API response
-      def get_package_tracking_details(package_number)
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def get_package_tracking_details(package_number, rate_limit: 2.0)
         path = "/fba/outbound/2020-07-01/tracking"
         params = {
           "packageNumber" => package_number,
         }.compact
 
-        rate_limit(2.0).get(path, params:)
+        meter(rate_limit).get(path, params:)
       end
 
       # Returns a list of return reason codes for a seller SKU in a given marketplace. The parameters for this operation
       # may contain special characters that require URL encoding. To avoid errors with SKUs when encoding URLs, refer to
       # [URL Encoding](https://developer-docs.amazon.com/sp-api/docs/url-encoding).
       #
-      # @param [String] seller_sku The seller SKU for which return reason codes are required.
-      # @param [String] marketplace_id The marketplace for which the seller wants return reason codes.
-      # @param [String] seller_fulfillment_order_id The identifier assigned to the item by the seller when the
+      # @note This operation can make a dynamic sandbox call.
+      # @param seller_sku [String] The seller SKU for which return reason codes are required.
+      # @param marketplace_id [String] The marketplace for which the seller wants return reason codes.
+      # @param seller_fulfillment_order_id [String] The identifier assigned to the item by the seller when the
       #   fulfillment order was created. The service uses this value to determine the marketplace for which the seller
       #   wants return reason codes.
-      # @param [String] language The language that the `TranslatedDescription` property of the `ReasonCodeDetails`
+      # @param language [String] The language that the `TranslatedDescription` property of the `ReasonCodeDetails`
       #   response object should be translated into.
-      # @return [Hash] The API response
-      def list_return_reason_codes(seller_sku, marketplace_id: nil, seller_fulfillment_order_id: nil, language: nil)
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def list_return_reason_codes(seller_sku, marketplace_id: nil, seller_fulfillment_order_id: nil, language: nil,
+        rate_limit: 2.0)
         path = "/fba/outbound/2020-07-01/returnReasonCodes"
         params = {
           "sellerSku" => seller_sku,
@@ -96,55 +115,63 @@ module Peddler
           "language" => language,
         }.compact
 
-        rate_limit(2.0).get(path, params:)
+        meter(rate_limit).get(path, params:)
       end
 
       # Creates a fulfillment return.
       #
-      # @param [Hash] body CreateFulfillmentReturnRequest parameter
-      # @param [String] seller_fulfillment_order_id An identifier assigned by the seller to the fulfillment order at the
+      # @note This operation can make a dynamic sandbox call.
+      # @param body [Hash] CreateFulfillmentReturnRequest parameter
+      # @param seller_fulfillment_order_id [String] An identifier assigned by the seller to the fulfillment order at the
       #   time it was created. The seller uses their own records to find the correct `SellerFulfillmentOrderId` value
       #   based on the buyer's request to return items.
-      # @return [Hash] The API response
-      def create_fulfillment_return(body, seller_fulfillment_order_id)
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def create_fulfillment_return(body, seller_fulfillment_order_id, rate_limit: 2.0)
         path = "/fba/outbound/2020-07-01/fulfillmentOrders/#{seller_fulfillment_order_id}/return"
 
-        rate_limit(2.0).put(path, body:)
+        meter(rate_limit).put(path, body:)
       end
 
       # Returns the fulfillment order indicated by the specified order identifier.
       #
-      # @param [String] seller_fulfillment_order_id The identifier assigned to the item by the seller when the
+      # @note This operation can make a dynamic sandbox call.
+      # @param seller_fulfillment_order_id [String] The identifier assigned to the item by the seller when the
       #   fulfillment order was created.
-      # @return [Hash] The API response
-      def get_fulfillment_order(seller_fulfillment_order_id)
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def get_fulfillment_order(seller_fulfillment_order_id, rate_limit: 2.0)
         path = "/fba/outbound/2020-07-01/fulfillmentOrders/#{seller_fulfillment_order_id}"
 
-        rate_limit(2.0).get(path)
+        meter(rate_limit).get(path)
       end
 
       # Updates and/or requests shipment for a fulfillment order with an order hold on it.
       #
-      # @param [Hash] body UpdateFulfillmentOrderRequest parameter
-      # @param [String] seller_fulfillment_order_id The identifier assigned to the item by the seller when the
+      # @note This operation can make a dynamic sandbox call.
+      # @param body [Hash] UpdateFulfillmentOrderRequest parameter
+      # @param seller_fulfillment_order_id [String] The identifier assigned to the item by the seller when the
       #   fulfillment order was created.
-      # @return [Hash] The API response
-      def update_fulfillment_order(body, seller_fulfillment_order_id)
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def update_fulfillment_order(body, seller_fulfillment_order_id, rate_limit: 2.0)
         path = "/fba/outbound/2020-07-01/fulfillmentOrders/#{seller_fulfillment_order_id}"
 
-        rate_limit(2.0).put(path, body:)
+        meter(rate_limit).put(path, body:)
       end
 
       # Requests that Amazon stop attempting to fulfill the fulfillment order indicated by the specified order
       # identifier.
       #
-      # @param [String] seller_fulfillment_order_id The identifier assigned to the item by the seller when the
+      # @note This operation can make a dynamic sandbox call.
+      # @param seller_fulfillment_order_id [String] The identifier assigned to the item by the seller when the
       #   fulfillment order was created.
-      # @return [Hash] The API response
-      def cancel_fulfillment_order(seller_fulfillment_order_id)
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def cancel_fulfillment_order(seller_fulfillment_order_id, rate_limit: 2.0)
         path = "/fba/outbound/2020-07-01/fulfillmentOrders/#{seller_fulfillment_order_id}/cancel"
 
-        rate_limit(2.0).put(path)
+        meter(rate_limit).put(path)
       end
 
       # Requests that Amazon update the status of an order in the sandbox testing environment. This is a sandbox-only
@@ -153,11 +180,15 @@ module Peddler
       # Partner API sandbox](https://developer-docs.amazon.com/sp-api/docs/the-selling-partner-api-sandbox) for more
       # information.
       #
-      # @param [String] seller_fulfillment_order_id The identifier assigned to the item by the seller when the
+      # @note This operation can make a dynamic sandbox call.
+      # @param seller_fulfillment_order_id [String] The identifier assigned to the item by the seller when the
       #   fulfillment order was created.
-      # @param [Hash] body The identifier assigned to the item by the seller when the fulfillment order was created.
-      # @return [Hash] The API response
-      def submit_fulfillment_order_status_update(seller_fulfillment_order_id, body)
+      # @param body [Hash] The identifier assigned to the item by the seller when the fulfillment order was created.
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def submit_fulfillment_order_status_update(seller_fulfillment_order_id, body, rate_limit: nil)
+        must_sandbox!
+
         path = "/fba/outbound/2020-07-01/fulfillmentOrders/#{seller_fulfillment_order_id}/status"
 
         put(path, body:)
@@ -166,29 +197,33 @@ module Peddler
       # Returns a list of features available for Multi-Channel Fulfillment orders in the marketplace you specify, and
       # whether the seller for which you made the call is enrolled for each feature.
       #
-      # @param [String] marketplace_id The marketplace for which to return the list of features.
-      # @return [Hash] The API response
-      def get_features(marketplace_id)
+      # @note This operation can make a dynamic sandbox call.
+      # @param marketplace_id [String] The marketplace for which to return the list of features.
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def get_features(marketplace_id, rate_limit: 2.0)
         path = "/fba/outbound/2020-07-01/features"
         params = {
           "marketplaceId" => marketplace_id,
         }.compact
 
-        rate_limit(2.0).get(path, params:)
+        meter(rate_limit).get(path, params:)
       end
 
       # Returns a list of inventory items that are eligible for the fulfillment feature you specify.
       #
-      # @param [String] marketplace_id The marketplace for which to return a list of the inventory that is eligible for
+      # @note This operation can make a dynamic sandbox call.
+      # @param marketplace_id [String] The marketplace for which to return a list of the inventory that is eligible for
       #   the specified feature.
-      # @param [String] feature_name The name of the feature for which to return a list of eligible inventory.
-      # @param [String] next_token A string token returned in the response to your previous request that is used to
+      # @param feature_name [String] The name of the feature for which to return a list of eligible inventory.
+      # @param next_token [String] A string token returned in the response to your previous request that is used to
       #   return the next response page. A value of null will return the first page.
-      # @param [String] query_start_date A date that you can use to select inventory that has been updated since a
+      # @param query_start_date [String] A date that you can use to select inventory that has been updated since a
       #   specified date. An update is defined as any change in feature-enabled inventory availability. The date must be
       #   in the format yyyy-MM-ddTHH:mm:ss.sssZ
-      # @return [Hash] The API response
-      def get_feature_inventory(marketplace_id, feature_name, next_token: nil, query_start_date: nil)
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def get_feature_inventory(marketplace_id, feature_name, next_token: nil, query_start_date: nil, rate_limit: 2.0)
         path = "/fba/outbound/2020-07-01/features/inventory/#{feature_name}"
         params = {
           "marketplaceId" => marketplace_id,
@@ -196,7 +231,7 @@ module Peddler
           "queryStartDate" => query_start_date,
         }.compact
 
-        rate_limit(2.0).get(path, params:)
+        meter(rate_limit).get(path, params:)
       end
 
       # Returns the number of items with the sellerSKU you specify that can have orders fulfilled using the specified
@@ -204,18 +239,20 @@ module Peddler
       # parameters for this operation may contain special characters that require URL encoding. To avoid errors with
       # SKUs when encoding URLs, refer to [URL Encoding](https://developer-docs.amazon.com/sp-api/docs/url-encoding).
       #
-      # @param [String] marketplace_id The marketplace for which to return the count.
-      # @param [String] feature_name The name of the feature.
-      # @param [String] seller_sku Used to identify an item in the given marketplace. `SellerSKU` is qualified by the
+      # @note This operation can make a dynamic sandbox call.
+      # @param marketplace_id [String] The marketplace for which to return the count.
+      # @param feature_name [String] The name of the feature.
+      # @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.
-      # @return [Hash] The API response
-      def get_feature_sku(marketplace_id, feature_name, seller_sku)
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def get_feature_sku(marketplace_id, feature_name, seller_sku, rate_limit: 2.0)
         path = "/fba/outbound/2020-07-01/features/inventory/#{feature_name}/#{seller_sku}"
         params = {
           "marketplaceId" => marketplace_id,
         }.compact
 
-        rate_limit(2.0).get(path, params:)
+        meter(rate_limit).get(path, params:)
       end
     end
   end

data/lib/peddler/apis/invoices_2024_06_19.rb

@@ -0,0 +1,180 @@
+# frozen_string_literal: true
+
+require "peddler/api"
+
+module Peddler
+  class << self
+    def invoices_2024_06_19(...)
+      APIs::Invoices20240619.new(...)
+    end
+  end
+
+  module APIs
+    # The Selling Partner API for Invoices.
+    #
+    # Use the Selling Partner API for Invoices to retrieve and manage invoice-related operations, which can help selling
+    # partners manage their bookkeeping processes.
+    class Invoices20240619 < API
+      # Returns marketplace-dependent schemas and their respective set of possible values.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param marketplace_id [String] The marketplace identifier.
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def get_invoices_attributes(marketplace_id, rate_limit: 1.0)
+        path = "/tax/invoices/2024-06-19/attributes"
+        params = {
+          "marketplaceId" => marketplace_id,
+        }.compact
+
+        meter(rate_limit).get(path, params:)
+      end
+
+      # Returns the invoice document's ID and URL. Use the URL to download the ZIP file, which contains the invoices
+      # from the corresponding `createInvoicesExport` request.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param invoices_document_id [String] The export document identifier.
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def get_invoices_document(invoices_document_id, rate_limit: 0.0167)
+        path = "/tax/invoices/2024-06-19/documents/#{invoices_document_id}"
+
+        meter(rate_limit).get(path)
+      end
+
+      # Creates an invoice export request.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param body [Hash] Information required to create the export request.
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def create_invoices_export(body, rate_limit: 0.167)
+        path = "/tax/invoices/2024-06-19/exports"
+
+        meter(rate_limit).post(path, body:)
+      end
+
+      # Returns invoice exports details for exports that match the filters that you specify.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param marketplace_id [String] The returned exports match the specified marketplace.
+      # @param date_start [String] The earliest export creation date and time for exports that you want to include in
+      #   the response. Values are in [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) date-time
+      #   format. The default is 30 days ago.
+      # @param next_token [String] The response includes `nextToken` when the number of results exceeds the specified
+      #   `pageSize` value. To get the next page of results, call the operation with this token and include the same
+      #   arguments as the call that produced the token. To get a complete list, call this operation until `nextToken`
+      #   is null. Note that this operation can return empty pages.
+      # @param page_size [Integer] The maximum number of invoices to return in a single call. Minimum: 1 Maximum: 100
+      # @param date_end [String] The latest export creation date and time for exports that you want to include in the
+      #   response. Values are in [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) date-time format.
+      #   The default value is the time of the request.
+      # @param status [String] Return exports matching the status specified.
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def get_invoices_exports(marketplace_id, date_start: nil, next_token: nil, page_size: nil, date_end: nil,
+        status: nil, rate_limit: 0.1)
+        path = "/tax/invoices/2024-06-19/exports"
+        params = {
+          "marketplaceId" => marketplace_id,
+          "dateStart" => date_start,
+          "nextToken" => next_token,
+          "pageSize" => page_size,
+          "dateEnd" => date_end,
+          "status" => status,
+        }.compact
+
+        meter(rate_limit).get(path, params:)
+      end
+
+      # Returns invoice export details (including the `exportDocumentId`, if available) for the export that you specify.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param export_id [String] The unique identifier for the export.
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def get_invoices_export(export_id, rate_limit: 2.0)
+        path = "/tax/invoices/2024-06-19/exports/#{export_id}"
+
+        meter(rate_limit).get(path)
+      end
+
+      # Returns invoice details for the invoices that match the filters that you specify.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param transaction_identifier_name [String] The name of the transaction identifier filter. If you provide a
+      #   value for this field, you must also provide a value for the `transactionIdentifierId` field.Use the
+      #   `getInvoicesAttributes` operation to check `transactionIdentifierName` options.
+      # @param page_size [Integer] The maximum number of invoices you want to return in a single call. Minimum: 1
+      #   Maximum: 200
+      # @param date_end [String] The latest invoice creation date for invoices that you want to include in the response.
+      #   Dates are in [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) date-time format. The default
+      #   is the current date-time.
+      # @param marketplace_id [String] The response includes only the invoices that match the specified marketplace.
+      # @param transaction_type [String] The marketplace-specific classification of the transaction type for which the
+      #   invoice was created. Use the `getInvoicesAttributes` operation to check `transactionType` options.
+      # @param transaction_identifier_id [String] The ID of the transaction identifier filter. If you provide a value
+      #   for this field, you must also provide a value for the `transactionIdentifierName` field.
+      # @param date_start [String] The earliest invoice creation date for invoices that you want to include in the
+      #   response. Dates are in [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) date-time format.
+      #   The default is 24 hours prior to the time of the request.
+      # @param series [String] Return invoices with the specified series number.
+      # @param next_token [String] The response includes `nextToken` when the number of results exceeds the specified
+      #   `pageSize` value. To get the next page of results, call the operation with this token and include the same
+      #   arguments as the call that produced the token. To get a complete list, call this operation until `nextToken`
+      #   is null. Note that this operation can return empty pages.
+      # @param sort_order [String] Sort the invoices in the response in ascending or descending order.
+      # @param invoice_type [String] The marketplace-specific classification of the invoice type. Use the
+      #   `getInvoicesAttributes` operation to check `invoiceType` options.
+      # @param statuses [Array<String>] A list of statuses that you can use to filter invoices. Use the
+      #   `getInvoicesAttributes` operation to check invoice status options. Min count: 1
+      # @param external_invoice_id [String] Return invoices that match this external ID. This is typically the
+      #   Government Invoice ID.
+      # @param sort_by [String] The attribute by which you want to sort the invoices in the response.
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def get_invoices(marketplace_id, transaction_identifier_name: nil, page_size: nil, date_end: nil,
+        transaction_type: nil, transaction_identifier_id: nil, date_start: nil, series: nil, next_token: nil,
+        sort_order: nil, invoice_type: nil, statuses: nil, external_invoice_id: nil, sort_by: nil, rate_limit: 0.1)
+        path = "/tax/invoices/2024-06-19/invoices"
+        params = {
+          "transactionIdentifierName" => transaction_identifier_name,
+          "pageSize" => page_size,
+          "dateEnd" => date_end,
+          "marketplaceId" => marketplace_id,
+          "transactionType" => transaction_type,
+          "transactionIdentifierId" => transaction_identifier_id,
+          "dateStart" => date_start,
+          "series" => series,
+          "nextToken" => next_token,
+          "sortOrder" => sort_order,
+          "invoiceType" => invoice_type,
+          "statuses" => statuses,
+          "externalInvoiceId" => external_invoice_id,
+          "sortBy" => sort_by,
+        }.compact
+
+        meter(rate_limit).get(path, params:)
+      end
+
+      # Returns invoice data for the specified invoice. This operation returns only a subset of the invoices data; refer
+      # to the response definition to get all the possible attributes. To get the full invoice, use the
+      # `createInvoicesExport` operation to start an export request.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param marketplace_id [String] The marketplace from which you want the invoice.
+      # @param invoice_id [String] The invoice identifier.
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def get_invoice(marketplace_id, invoice_id, rate_limit: 2.0)
+        path = "/tax/invoices/2024-06-19/invoices/#{invoice_id}"
+        params = {
+          "marketplaceId" => marketplace_id,
+        }.compact
+
+        meter(rate_limit).get(path, params:)
+      end
+    end
+  end
+end

data/lib/peddler/apis/listings_items_2020_09_01.rb

@@ -0,0 +1,95 @@
+# frozen_string_literal: true
+
+require "peddler/api"
+
+module Peddler
+  class << self
+    def listings_items_2020_09_01(...)
+      APIs::ListingsItems20200901.new(...)
+    end
+  end
+
+  module APIs
+    # Selling Partner API for Listings Items
+    #
+    # 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 {https://developer-docs.amazon.com/sp-api/docs/listings-items-api-v2020-09-01-use-case-guide
+    # Listing Items API Use Case Guide}.
+    class ListingsItems20200901 < 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/2020-09-01/items/#{seller_id}/#{sku}"
+        params = {
+          "marketplaceIds" => marketplace_ids,
+          "issueLocale" => issue_locale,
+        }.compact
+
+        meter(rate_limit).delete(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:** 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 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, issue_locale: nil, rate_limit: 5.0)
+        path = "/listings/2020-09-01/items/#{seller_id}/#{sku}"
+        params = {
+          "marketplaceIds" => marketplace_ids,
+          "issueLocale" => issue_locale,
+        }.compact
+
+        meter(rate_limit).patch(path, body:, params:)
+      end
+
+      # Creates a new or fully-updates an existing 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 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, issue_locale: nil, rate_limit: 5.0)
+        path = "/listings/2020-09-01/items/#{seller_id}/#{sku}"
+        params = {
+          "marketplaceIds" => marketplace_ids,
+          "issueLocale" => issue_locale,
+        }.compact
+
+        meter(rate_limit).put(path, body:, params:)
+      end
+    end
+  end
+end