peddler 4.5.0 → 4.6.1

data/lib/peddler/apis/fulfillment_inbound_v0.rb

@@ -14,6 +14,8 @@ module Peddler
     #
     # The Selling Partner API for Fulfillment Inbound lets you create applications that create and update inbound
     # shipments of inventory to Amazon's fulfillment network.
+    #
+    # @see https://github.com/amzn/selling-partner-api-models/blob/main/models/fulfillmentInboundV0.json
     class FulfillmentInboundV0 < API
       # Returns labeling requirements and item preparation instructions to help prepare items for shipment to Amazon's
       # fulfillment network.
@@ -42,8 +44,8 @@ module Peddler
           "SellerSKUList" => stringify_array(seller_sku_list),
           "ASINList" => stringify_array(asin_list),
         }.compact
-
-        meter(rate_limit).get(path, params:)
+        parser = Peddler::Types::FulfillmentInboundV0::GetPrepInstructionsResponse if typed?
+        meter(rate_limit).get(path, params:, parser:)
       end
 
       # Returns package/pallet labels for faster and more accurate shipment processing at the Amazon fulfillment center.
@@ -62,9 +64,8 @@ module Peddler
       #   then `PackageLabelsToPrint` must match the `CartonId` values you provide through that feed. If you provide box
       #   content information with the Fulfillment Inbound API v2024-03-20, then `PackageLabelsToPrint` must match the
       #   `boxID` values from the
-      #   [`listShipmentBoxes`](https://developer-docs.amazon.com/sp-api/docs/fulfillment-inbound-api-v2024-03-20-reference#listshipmentboxes)
-      #   response. If these values do not match as required, the operation returns the `IncorrectPackageIdentifier`
-      #   error code.
+      #   [`listShipmentBoxes`](https://developer-docs.amazon.com/sp-api/reference/listshipmentboxes) response. If these
+      #   values do not match as required, the operation returns the `IncorrectPackageIdentifier` error code.
       # @param number_of_pallets [Integer] The number of pallets in the shipment. This returns four identical labels for
       #   each pallet.
       # @param page_size [Integer] The page size for paginating through the total packages' labels. This is a required
@@ -85,8 +86,8 @@ module Peddler
           "PageSize" => page_size,
           "PageStartIndex" => page_start_index,
         }.compact
-
-        meter(rate_limit).get(path, params:)
+        parser = Peddler::Types::FulfillmentInboundV0::GetLabelsResponse if typed?
+        meter(rate_limit).get(path, params:, parser:)
       end
 
       # Returns a bill of lading for a Less Than Truckload/Full Truckload (LTL/FTL) shipment. The getBillOfLading
@@ -100,8 +101,8 @@ module Peddler
       # @return [Peddler::Response] The API response
       def get_bill_of_lading(shipment_id, rate_limit: 2.0)
         path = "/fba/inbound/v0/shipments/#{percent_encode(shipment_id)}/billOfLading"
-
-        meter(rate_limit).get(path)
+        parser = Peddler::Types::FulfillmentInboundV0::GetBillOfLadingResponse if typed?
+        meter(rate_limit).get(path, parser:)
       end
 
       # Returns a list of inbound shipments based on criteria that you specify.
@@ -137,8 +138,8 @@ module Peddler
           "NextToken" => next_token,
           "MarketplaceId" => marketplace_id,
         }.compact
-
-        meter(rate_limit).get(path, params:)
+        parser = Peddler::Types::FulfillmentInboundV0::GetShipmentsResponse if typed?
+        meter(rate_limit).get(path, params:, parser:)
       end
 
       # Returns a list of items in a specified inbound shipment.
@@ -153,8 +154,8 @@ module Peddler
         params = {
           "MarketplaceId" => marketplace_id,
         }.compact
-
-        meter(rate_limit).get(path, params:)
+        parser = Peddler::Types::FulfillmentInboundV0::GetShipmentItemsResponse if typed?
+        meter(rate_limit).get(path, params:, parser:)
       end
 
       # Returns a list of items in a specified inbound shipment, or a list of items that were updated within a specified
@@ -183,8 +184,14 @@ module Peddler
           "NextToken" => next_token,
           "MarketplaceId" => marketplace_id,
         }.compact
+        parser = Peddler::Types::FulfillmentInboundV0::GetShipmentItemsResponse if typed?
+        meter(rate_limit).get(path, params:, parser:)
+      end
+
+      private
 
-        meter(rate_limit).get(path, params:)
+      def load_types
+        require "peddler/types/fulfillment_inbound_v0"
       end
     end
   end

data/lib/peddler/apis/fulfillment_outbound_2020_07_01.rb

@@ -15,6 +15,8 @@ module Peddler
     # The Selling Partner API for Fulfillment Outbound lets you create applications that help a seller fulfill
     # Multi-Channel Fulfillment orders using their inventory in Amazon's fulfillment network. You can get information on
     # both potential and existing fulfillment orders.
+    #
+    # @see https://github.com/amzn/selling-partner-api-models/blob/main/models/fulfillmentOutbound_2020-07-01.json
     class FulfillmentOutbound20200701 < API
       # Returns a list of fulfillment order previews based on shipping criteria that you specify.
       #
@@ -24,8 +26,8 @@ module Peddler
       # @return [Peddler::Response] The API response
       def get_fulfillment_preview(body, rate_limit: 2.0)
         path = "/fba/outbound/2020-07-01/fulfillmentOrders/preview"
-
-        meter(rate_limit).post(path, body:)
+        parser = Peddler::Types::FulfillmentOutbound20200701::GetFulfillmentPreviewResponse if typed?
+        meter(rate_limit).post(path, body:, parser:)
       end
 
       # Returns delivery options that include an estimated delivery date and offer expiration, based on criteria that
@@ -37,12 +39,12 @@ module Peddler
       # @return [Peddler::Response] The API response
       def delivery_offers(body, rate_limit: 5.0)
         path = "/fba/outbound/2020-07-01/deliveryOffers"
-
-        meter(rate_limit).post(path, body:)
+        parser = Peddler::Types::FulfillmentOutbound20200701::GetDeliveryOffersResponse if typed?
+        meter(rate_limit).post(path, body:, parser:)
       end
 
-      # Returns a list of fulfillment orders fulfilled after (or at) a specified date-time, or indicated by the next
-      # token parameter.
+      # Returns a list of fulfillment orders fulfilled after (or at) a specified date-time, or indicated by the
+      # `nextToken` parameter.
       #
       # @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
@@ -57,8 +59,8 @@ module Peddler
           "queryStartDate" => query_start_date,
           "nextToken" => next_token,
         }.compact
-
-        meter(rate_limit).get(path, params:)
+        parser = Peddler::Types::FulfillmentOutbound20200701::ListAllFulfillmentOrdersResponse if typed?
+        meter(rate_limit).get(path, params:, parser:)
       end
 
       # Requests that Amazon ship items from the seller's inventory in Amazon's fulfillment network to a destination
@@ -70,25 +72,28 @@ module Peddler
       # @return [Peddler::Response] The API response
       def create_fulfillment_order(body, rate_limit: 2.0)
         path = "/fba/outbound/2020-07-01/fulfillmentOrders"
-
-        meter(rate_limit).post(path, body:)
+        parser = Peddler::Types::FulfillmentOutbound20200701::CreateFulfillmentOrderResponse if typed?
+        meter(rate_limit).post(path, body:, parser:)
       end
 
       # Returns delivery tracking information for a package in an outbound shipment for a Multi-Channel Fulfillment
       # order.
       #
       # @note This operation can make a dynamic sandbox call.
-      # @param package_number [Integer] The unencrypted package identifier returned by the `getFulfillmentOrder`
-      #   operation.
+      # @param package_number [Integer] The unencrypted package identifier. You can obtain this value from the
+      #   `getFulfillmentOrder` operation.
+      # @param amazon_fulfillment_tracking_number [String] The Amazon fulfillment tracking number. You can obtain this
+      #   value from the `getFulfillmentOrder` operation.
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
-      def get_package_tracking_details(package_number, rate_limit: 2.0)
+      def get_package_tracking_details(package_number: nil, amazon_fulfillment_tracking_number: nil, rate_limit: 2.0)
         path = "/fba/outbound/2020-07-01/tracking"
         params = {
           "packageNumber" => package_number,
+          "amazonFulfillmentTrackingNumber" => amazon_fulfillment_tracking_number,
         }.compact
-
-        meter(rate_limit).get(path, params:)
+        parser = Peddler::Types::FulfillmentOutbound20200701::GetPackageTrackingDetailsResponse if typed?
+        meter(rate_limit).get(path, params:, parser:)
       end
 
       # Returns a list of return reason codes for a seller SKU in a given marketplace. The parameters for this operation
@@ -114,23 +119,23 @@ module Peddler
           "sellerFulfillmentOrderId" => seller_fulfillment_order_id,
           "language" => language,
         }.compact
-
-        meter(rate_limit).get(path, params:)
+        parser = Peddler::Types::FulfillmentOutbound20200701::ListReturnReasonCodesResponse if typed?
+        meter(rate_limit).get(path, params:, parser:)
       end
 
       # Creates a fulfillment return.
       #
       # @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
+      # @param body [Hash] The request body of the `createFulfillmentReturn` operation.
+      # @param seller_fulfillment_order_id [String] An identifier the seller assigns 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.
       # @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/#{percent_encode(seller_fulfillment_order_id)}/return"
-
-        meter(rate_limit).put(path, body:)
+        parser = Peddler::Types::FulfillmentOutbound20200701::CreateFulfillmentReturnResponse if typed?
+        meter(rate_limit).put(path, body:, parser:)
       end
 
       # Returns the fulfillment order indicated by the specified order identifier.
@@ -142,22 +147,22 @@ module Peddler
       # @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/#{percent_encode(seller_fulfillment_order_id)}"
-
-        meter(rate_limit).get(path)
+        parser = Peddler::Types::FulfillmentOutbound20200701::GetFulfillmentOrderResponse if typed?
+        meter(rate_limit).get(path, parser:)
       end
 
       # Updates and/or requests shipment for a fulfillment order with an order hold on it.
       #
       # @note This operation can make a dynamic sandbox call.
-      # @param body [Hash] UpdateFulfillmentOrderRequest parameter
+      # @param body [Hash] The request body of the `updateFulfillmentOrder` operation.
       # @param seller_fulfillment_order_id [String] 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 update_fulfillment_order(body, seller_fulfillment_order_id, rate_limit: 2.0)
         path = "/fba/outbound/2020-07-01/fulfillmentOrders/#{percent_encode(seller_fulfillment_order_id)}"
-
-        meter(rate_limit).put(path, body:)
+        parser = Peddler::Types::FulfillmentOutbound20200701::UpdateFulfillmentOrderResponse if typed?
+        meter(rate_limit).put(path, body:, parser:)
       end
 
       # Requests that Amazon stop attempting to fulfill the fulfillment order indicated by the specified order
@@ -170,8 +175,8 @@ module Peddler
       # @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/#{percent_encode(seller_fulfillment_order_id)}/cancel"
-
-        meter(rate_limit).put(path)
+        parser = Peddler::Types::FulfillmentOutbound20200701::CancelFulfillmentOrderResponse if typed?
+        meter(rate_limit).put(path, parser:)
       end
 
       # Requests that Amazon update the status of an order in the sandbox testing environment. This is a sandbox-only
@@ -186,11 +191,9 @@ module Peddler
       # @param body [Hash] The identifier assigned to the item by the seller when the fulfillment order was created.
       # @return [Peddler::Response] The API response
       def submit_fulfillment_order_status_update(seller_fulfillment_order_id, body)
-        must_sandbox!
-
         path = "/fba/outbound/2020-07-01/fulfillmentOrders/#{percent_encode(seller_fulfillment_order_id)}/status"
-
-        put(path, body:)
+        parser = Peddler::Types::FulfillmentOutbound20200701::SubmitFulfillmentOrderStatusUpdateResponse if typed?
+        put(path, body:, parser:)
       end
 
       # Returns a list of features available for Multi-Channel Fulfillment orders in the marketplace you specify, and
@@ -205,8 +208,8 @@ module Peddler
         params = {
           "marketplaceId" => marketplace_id,
         }.compact
-
-        meter(rate_limit).get(path, params:)
+        parser = Peddler::Types::FulfillmentOutbound20200701::GetFeaturesResponse if typed?
+        meter(rate_limit).get(path, params:, parser:)
       end
 
       # Returns a list of inventory items that are eligible for the fulfillment feature you specify.
@@ -216,10 +219,10 @@ module Peddler
       #   the specified feature.
       # @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.
+      #   return the next response page. A value of `null` will return the first page.
       # @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
+      #   in the format `yyyy-MM-ddTHH:mm:ss.sssZ`
       # @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)
@@ -229,20 +232,20 @@ module Peddler
           "nextToken" => next_token,
           "queryStartDate" => query_start_date,
         }.compact
-
-        meter(rate_limit).get(path, params:)
+        parser = Peddler::Types::FulfillmentOutbound20200701::GetFeatureInventoryResponse if typed?
+        meter(rate_limit).get(path, params:, parser:)
       end
 
-      # Returns the number of items with the sellerSKU you specify that can have orders fulfilled using the specified
-      # feature. Note that if the sellerSKU isn't eligible, the response will contain an empty skuInfo object. The
+      # Returns the number of items with the `sellerSku` you specify that can have orders fulfilled using the specified
+      # feature. Note that if the `sellerSku` isn't eligible, the response will contain an empty `skuInfo` object. 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).
       #
       # @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.
+      # @param seller_sku [String] Used to identify an item in the given marketplace. `sellerSku` is qualified by the
+      #   seller's `sellerId`, which is included with every operation that you submit.
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def get_feature_sku(marketplace_id, feature_name, seller_sku, rate_limit: 2.0)
@@ -250,8 +253,14 @@ module Peddler
         params = {
           "marketplaceId" => marketplace_id,
         }.compact
+        parser = Peddler::Types::FulfillmentOutbound20200701::GetFeatureSkuResponse if typed?
+        meter(rate_limit).get(path, params:, parser:)
+      end
+
+      private
 
-        meter(rate_limit).get(path, params:)
+      def load_types
+        require "peddler/types/fulfillment_outbound_2020_07_01"
       end
     end
   end

data/lib/peddler/apis/invoices_2024_06_19.rb

@@ -14,6 +14,8 @@ module Peddler
     #
     # Use the Selling Partner API for Invoices to retrieve and manage invoice-related operations, which can help selling
     # partners manage their bookkeeping processes.
+    #
+    # @see https://github.com/amzn/selling-partner-api-models/blob/main/models/InvoicesApiModel_2024-06-19.json
     class Invoices20240619 < API
       # Returns marketplace-dependent schemas and their respective set of possible values.
       #
@@ -26,8 +28,8 @@ module Peddler
         params = {
           "marketplaceId" => marketplace_id,
         }.compact
-
-        meter(rate_limit).get(path, params:)
+        parser = Peddler::Types::Invoices20240619::GetInvoicesAttributesResponse if typed?
+        meter(rate_limit).get(path, params:, parser:)
       end
 
       # Returns the invoice document's ID and URL. Use the URL to download the ZIP file, which contains the invoices
@@ -39,8 +41,8 @@ module Peddler
       # @return [Peddler::Response] The API response
       def get_invoices_document(invoices_document_id, rate_limit: 0.0167)
         path = "/tax/invoices/2024-06-19/documents/#{percent_encode(invoices_document_id)}"
-
-        meter(rate_limit).get(path)
+        parser = Peddler::Types::Invoices20240619::GetInvoicesDocumentResponse if typed?
+        meter(rate_limit).get(path, parser:)
       end
 
       # Creates an invoice export request.
@@ -51,8 +53,8 @@ module Peddler
       # @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:)
+        parser = Peddler::Types::Invoices20240619::ExportInvoicesResponse if typed?
+        meter(rate_limit).post(path, body:, parser:)
       end
 
       # Returns invoice exports details for exports that match the filters that you specify.
@@ -84,8 +86,8 @@ module Peddler
           "dateEnd" => date_end,
           "status" => status,
         }.compact
-
-        meter(rate_limit).get(path, params:)
+        parser = Peddler::Types::Invoices20240619::GetInvoicesExportsResponse if typed?
+        meter(rate_limit).get(path, params:, parser:)
       end
 
       # Returns invoice export details (including the `exportDocumentId`, if available) for the export that you specify.
@@ -96,8 +98,8 @@ module Peddler
       # @return [Peddler::Response] The API response
       def get_invoices_export(export_id, rate_limit: 2.0)
         path = "/tax/invoices/2024-06-19/exports/#{percent_encode(export_id)}"
-
-        meter(rate_limit).get(path)
+        parser = Peddler::Types::Invoices20240619::GetInvoicesExportResponse if typed?
+        meter(rate_limit).get(path, parser:)
       end
 
       # Returns invoice details for the invoices that match the filters that you specify.
@@ -154,13 +156,13 @@ module Peddler
           "externalInvoiceId" => external_invoice_id,
           "sortBy" => sort_by,
         }.compact
-
-        meter(rate_limit).get(path, params:)
+        parser = Peddler::Types::Invoices20240619::GetInvoicesResponse if typed?
+        meter(rate_limit).get(path, params:, parser:)
       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.
+      # 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.
@@ -172,8 +174,14 @@ module Peddler
         params = {
           "marketplaceId" => marketplace_id,
         }.compact
+        parser = Peddler::Types::Invoices20240619::GetInvoiceResponse if typed?
+        meter(rate_limit).get(path, params:, parser:)
+      end
+
+      private
 
-        meter(rate_limit).get(path, params:)
+      def load_types
+        require "peddler/types/invoices_2024_06_19"
       end
     end
   end

data/lib/peddler/apis/listings_items_2020_09_01.rb

@@ -14,13 +14,19 @@ module Peddler
     #
     # 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}.
+    # 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}.
+    #
+    # @see https://github.com/amzn/selling-partner-api-models/blob/main/models/listingsItems_2020-09-01.json
     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).
+      # 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.
@@ -37,14 +43,16 @@ module Peddler
           "marketplaceIds" => stringify_array(marketplace_ids),
           "issueLocale" => issue_locale,
         }.compact
-
-        meter(rate_limit).delete(path, params:)
+        parser = Peddler::Types::ListingsItems20200901::ListingsItemSubmissionResponse if typed?
+        meter(rate_limit).delete(path, params:, parser:)
       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).
+      # 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.
@@ -62,13 +70,14 @@ module Peddler
           "marketplaceIds" => stringify_array(marketplace_ids),
           "issueLocale" => issue_locale,
         }.compact
-
-        meter(rate_limit).patch(path, body:, params:)
+        parser = Peddler::Types::ListingsItems20200901::ListingsItemSubmissionResponse if typed?
+        meter(rate_limit).patch(path, body:, params:, parser:)
       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
+      # 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.
@@ -87,8 +96,14 @@ module Peddler
           "marketplaceIds" => stringify_array(marketplace_ids),
           "issueLocale" => issue_locale,
         }.compact
+        parser = Peddler::Types::ListingsItems20200901::ListingsItemSubmissionResponse if typed?
+        meter(rate_limit).put(path, body:, params:, parser:)
+      end
+
+      private
 
-        meter(rate_limit).put(path, body:, params:)
+      def load_types
+        require "peddler/types/listings_items_2020_09_01"
       end
     end
   end

data/lib/peddler/apis/listings_items_2021_08_01.rb

@@ -14,13 +14,14 @@ module Peddler
     #
     # The Selling Partner API for Listings Items (Listings Items API) provides programmatic access to selling partner
     # listings on Amazon. Use this API in collaboration with the Selling Partner API for Product Type Definitions, which
-    # you use to retrieve the information about Amazon product types needed to use the Listings Items API. For more
-    # information, see the [Listings Items API Use Case
+    # you use to retrieve the information about Amazon product types needed to use the Listings Items API.
+    #
+    # For more information, see the [Listings Items API Use Case
     # Guide](https://developer-docs.amazon.com/sp-api/docs/listings-items-api-v2021-08-01-use-case-guide).
+    #
+    # @see https://github.com/amzn/selling-partner-api-models/blob/main/models/listingsItems_2021-08-01.json
     class ListingsItems20210801 < API
-      # Delete a listings item for a selling partner. **Note:** The parameters associated with this operation may
-      # contain special characters that must be encoded to successfully call the API. To avoid errors with SKUs when
-      # encoding URLs, refer to [URL Encoding](https://developer-docs.amazon.com/sp-api/docs/url-encoding).
+      # Delete a listings item for a selling partner.
       #
       # @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.
@@ -37,8 +38,8 @@ module Peddler
           "marketplaceIds" => stringify_array(marketplace_ids),
           "issueLocale" => issue_locale,
         }.compact
-
-        meter(rate_limit).delete(path, params:)
+        parser = Peddler::Types::ListingsItems20210801::ListingsItemSubmissionResponse if typed?
+        meter(rate_limit).delete(path, params:, parser:)
       end
 
       # Returns details about a listings item for a selling partner.
@@ -62,8 +63,8 @@ module Peddler
           "issueLocale" => issue_locale,
           "includedData" => stringify_array(included_data),
         }.compact
-
-        meter(rate_limit).get(path, params:)
+        parser = Peddler::Types::ListingsItems20210801::Item if typed?
+        meter(rate_limit).get(path, params:, parser:)
       end
 
       # Partially update (patch) a listings item for a selling partner. Only top-level listings item attributes can be
@@ -91,8 +92,8 @@ module Peddler
           "mode" => mode,
           "issueLocale" => issue_locale,
         }.compact
-
-        meter(rate_limit).patch(path, body:, params:)
+        parser = Peddler::Types::ListingsItems20210801::ListingsItemSubmissionResponse if typed?
+        meter(rate_limit).patch(path, body:, params:, parser:)
       end
 
       # Creates a new or fully-updates an existing listings item for a selling partner.
@@ -119,8 +120,8 @@ module Peddler
           "mode" => mode,
           "issueLocale" => issue_locale,
         }.compact
-
-        meter(rate_limit).put(path, body:, params:)
+        parser = Peddler::Types::ListingsItems20210801::ListingsItemSubmissionResponse if typed?
+        meter(rate_limit).put(path, body:, params:, parser:)
       end
 
       # Search for and return a list of selling partner listings items and their respective details.
@@ -194,8 +195,14 @@ module Peddler
           "pageSize" => page_size,
           "pageToken" => page_token,
         }.compact
+        parser = Peddler::Types::ListingsItems20210801::ItemSearchResults if typed?
+        meter(rate_limit).get(path, params:, parser:)
+      end
+
+      private
 
-        meter(rate_limit).get(path, params:)
+      def load_types
+        require "peddler/types/listings_items_2021_08_01"
       end
     end
   end

data/lib/peddler/apis/listings_restrictions_2021_08_01.rb

@@ -13,9 +13,13 @@ module Peddler
     # Selling Partner API for Listings Restrictions
     #
     # The Selling Partner API for Listings Restrictions provides programmatic access to restrictions on Amazon catalog
-    # listings. For more information, see the
+    # listings.
+    #
+    # For more information, see the
     # {https://developer-docs.amazon.com/sp-api/docs/listings-restrictions-api-v2021-08-01-use-case-guide Listings
     # Restrictions API Use Case Guide}.
+    #
+    # @see https://github.com/amzn/selling-partner-api-models/blob/main/models/listingsRestrictions_2021-08-01.json
     class ListingsRestrictions20210801 < API
       # Returns listing restrictions for an item in the Amazon Catalog.
       #
@@ -39,8 +43,14 @@ module Peddler
           "marketplaceIds" => stringify_array(marketplace_ids),
           "reasonLocale" => reason_locale,
         }.compact
+        parser = Peddler::Types::ListingsRestrictions20210801::RestrictionList if typed?
+        meter(rate_limit).get(path, params:, parser:)
+      end
+
+      private
 
-        meter(rate_limit).get(path, params:)
+      def load_types
+        require "peddler/types/listings_restrictions_2021_08_01"
       end
     end
   end