peddler 4.5.0 → 4.6.1

data/lib/peddler/apis/customer_feedback_2024_06_01.rb

@@ -14,6 +14,8 @@ module Peddler
     #
     # The Selling Partner API for Customer Feedback (Customer Feedback API) provides information about customer reviews
     # and returns at both the item and browse node level.
+    #
+    # @see https://github.com/amzn/selling-partner-api-models/blob/main/models/customerFeedback_2024-06-01.json
     class CustomerFeedback20240601 < API
       # Retrieve an item's ten most positive and ten most negative review topics.
       #
@@ -30,8 +32,8 @@ module Peddler
           "marketplaceId" => marketplace_id,
           "sortBy" => sort_by,
         }.compact
-
-        get(path, params:)
+        parser = Peddler::Types::CustomerFeedback20240601::ItemReviewTopicsResponse if typed?
+        get(path, params:, parser:)
       end
 
       # This API returns the associated browse node of the requested ASIN. A browse node is a location in a browse tree
@@ -48,8 +50,8 @@ module Peddler
         params = {
           "marketplaceId" => marketplace_id,
         }.compact
-
-        get(path, params:)
+        parser = Peddler::Types::CustomerFeedback20240601::BrowseNodeResponse if typed?
+        get(path, params:, parser:)
       end
 
       # Retrieve a browse node's ten most positive and ten most negative review topics.
@@ -67,8 +69,8 @@ module Peddler
           "marketplaceId" => marketplace_id,
           "sortBy" => sort_by,
         }.compact
-
-        get(path, params:)
+        parser = Peddler::Types::CustomerFeedback20240601::BrowseNodeReviewTopicsResponse if typed?
+        get(path, params:, parser:)
       end
 
       # Retrieve an item's positive and negative review trends for the past six months.
@@ -84,8 +86,8 @@ module Peddler
         params = {
           "marketplaceId" => marketplace_id,
         }.compact
-
-        get(path, params:)
+        parser = Peddler::Types::CustomerFeedback20240601::ItemReviewTrendsResponse if typed?
+        get(path, params:, parser:)
       end
 
       # Retrieve the positive and negative review trends of items in a browse node for the past six months.
@@ -101,8 +103,8 @@ module Peddler
         params = {
           "marketplaceId" => marketplace_id,
         }.compact
-
-        get(path, params:)
+        parser = Peddler::Types::CustomerFeedback20240601::BrowseNodeReviewTrendsResponse if typed?
+        get(path, params:, parser:)
       end
 
       # Retrieve the topics that customers mention when they return items in a browse node.
@@ -118,8 +120,8 @@ module Peddler
         params = {
           "marketplaceId" => marketplace_id,
         }.compact
-
-        get(path, params:)
+        parser = Peddler::Types::CustomerFeedback20240601::BrowseNodeReturnTopicsResponse if typed?
+        get(path, params:, parser:)
       end
 
       # Retrieve the trends of topics that customers mention when they return items in a browse node.
@@ -135,8 +137,14 @@ module Peddler
         params = {
           "marketplaceId" => marketplace_id,
         }.compact
+        parser = Peddler::Types::CustomerFeedback20240601::BrowseNodeReturnTrendsResponse if typed?
+        get(path, params:, parser:)
+      end
+
+      private
 
-        get(path, params:)
+      def load_types
+        require "peddler/types/customer_feedback_2024_06_01"
       end
     end
   end

data/lib/peddler/apis/data_kiosk_2023_11_15.rb

@@ -14,6 +14,8 @@ module Peddler
     #
     # The Selling Partner API for Data Kiosk lets you submit GraphQL queries from a variety of schemas to help selling
     # partners manage their businesses.
+    #
+    # @see https://github.com/amzn/selling-partner-api-models/blob/main/models/dataKiosk_2023-11-15.json
     class DataKiosk20231115 < API
       # Returns details for the Data Kiosk queries that match the specified filters. See the `createQuery` operation for
       # details about query retention.
@@ -42,15 +44,16 @@ module Peddler
           "createdUntil" => created_until,
           "paginationToken" => pagination_token,
         }.compact
-
-        meter(rate_limit).get(path, params:)
+        parser = Peddler::Types::DataKiosk20231115::GetQueriesResponse if typed?
+        meter(rate_limit).get(path, params:, parser:)
       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.
       #
       # @note This operation can make a static sandbox call.
       # @param body [Hash] The body of the request.
@@ -58,8 +61,8 @@ module Peddler
       # @return [Peddler::Response] The API response
       def create_query(body, rate_limit: 0.0167)
         path = "/dataKiosk/2023-11-15/queries"
-
-        meter(rate_limit).post(path, body:)
+        parser = Peddler::Types::DataKiosk20231115::CreateQueryResponse if typed?
+        meter(rate_limit).post(path, body:, parser:)
       end
 
       # Cancels the query specified by the `queryId` parameter. Only queries with a non-terminal `processingStatus`
@@ -74,7 +77,6 @@ module Peddler
       # @return [Peddler::Response] The API response
       def cancel_query(query_id, rate_limit: 0.0222)
         path = "/dataKiosk/2023-11-15/queries/#{percent_encode(query_id)}"
-
         meter(rate_limit).delete(path)
       end
 
@@ -87,8 +89,8 @@ module Peddler
       # @return [Peddler::Response] The API response
       def get_query(query_id, rate_limit: 2.0)
         path = "/dataKiosk/2023-11-15/queries/#{percent_encode(query_id)}"
-
-        meter(rate_limit).get(path)
+        parser = Peddler::Types::DataKiosk20231115::Query if typed?
+        meter(rate_limit).get(path, parser:)
       end
 
       # Returns the information required for retrieving a Data Kiosk document's contents. See the `createQuery`
@@ -100,8 +102,14 @@ module Peddler
       # @return [Peddler::Response] The API response
       def get_document(document_id, rate_limit: 0.0167)
         path = "/dataKiosk/2023-11-15/documents/#{percent_encode(document_id)}"
+        parser = Peddler::Types::DataKiosk20231115::GetDocumentResponse if typed?
+        meter(rate_limit).get(path, parser:)
+      end
+
+      private
 
-        meter(rate_limit).get(path)
+      def load_types
+        require "peddler/types/data_kiosk_2023_11_15"
       end
     end
   end

data/lib/peddler/apis/easy_ship_2022_03_23.rb

@@ -17,13 +17,19 @@ module Peddler
     # shipping labels, invoices, and warranties. To review the differences in Easy Ship operations by marketplace, refer
     # to [Marketplace
     # support](https://developer-docs.amazon.com/sp-api/docs/easyship-api-v2022-03-23-use-case-guide#marketplace-support).
+    #
+    # @see https://github.com/amzn/selling-partner-api-models/blob/main/models/easyShip_2022-03-23.json
     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
+      # 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
+      # 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}.
       #
@@ -34,8 +40,8 @@ module Peddler
       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:)
+        parser = Peddler::Types::EasyShip20220323::ListHandoverSlotsResponse if typed?
+        meter(rate_limit).post(path, body:, parser:)
       end
 
       # Returns information about a package, including dimensions, weight, time slot information for handover, invoice
@@ -53,18 +59,27 @@ module Peddler
           "amazonOrderId" => amazon_order_id,
           "marketplaceId" => marketplace_id,
         }.compact
-
-        meter(rate_limit).get(path, params:)
+        parser = Peddler::Types::EasyShip20220323::Package if typed?
+        meter(rate_limit).get(path, params:, parser:)
       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
+      # 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
+      # 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.
       #
@@ -75,13 +90,15 @@ module Peddler
       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:)
+        parser = Peddler::Types::EasyShip20220323::Package if typed?
+        meter(rate_limit).post(path, body:, parser:)
       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
+      # `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.
       #
@@ -92,24 +109,30 @@ module Peddler
       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:)
+        parser = Peddler::Types::EasyShip20220323::Packages if typed?
+        meter(rate_limit).patch(path, body:, parser:)
       end
 
       # This operation automatically schedules a time slot for all the `amazonOrderId`s given as input, generating the
       # associated shipping labels, along with other compliance documents according to the marketplace (refer to the
       # {https://developer-docs.amazon.com/sp-api/docs/easyship-api-v2022-03-23-use-case-guide#marketplace-support-table
-      # marketplace document support table}). Developers calling this operation may optionally assign a `packageDetails`
-      # object, allowing them to input a preferred time slot for each order in their request. In this case, Amazon will
-      # try to schedule the respective packages using their optional settings. On the other hand, *i.e.*, if the time
-      # slot is not provided, Amazon will then pick the earliest time slot possible. Regarding the shipping label's file
-      # format, external developers are able to choose between PDF or ZPL, and Amazon will create the label accordingly.
+      # marketplace document support table}).
+      #
+      # Developers calling this operation may optionally assign a `packageDetails` object, allowing them to input a
+      # preferred time slot for each order in their request. In this case, Amazon will try to schedule the respective
+      # packages using their optional settings. On the other hand, *i.e.*, if the time slot is not provided, Amazon will
+      # then pick the earliest time slot possible.
+      #
+      # Regarding the shipping label's file format, external developers are able to choose between PDF or ZPL, and
+      # Amazon will create the label accordingly.
+      #
       # This operation returns an array composed of the scheduled packages, and a short-lived URL pointing to a zip file
       # containing the generated shipping labels and the other documents enabled for your marketplace. If at least an
       # order couldn't be scheduled, then Amazon adds the `rejectedOrders` list into the response, which contains an
       # entry for each order we couldn't process. Each entry is composed of an error message describing the reason of
-      # the failure, so that sellers can take action. The table below displays the supported request and burst maximum
-      # rates:
+      # the failure, so that sellers can take action.
+      #
+      # The table below displays 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`
@@ -119,8 +142,14 @@ module Peddler
       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
+        parser = Peddler::Types::EasyShip20220323::CreateScheduledPackagesResponse if typed?
+        meter(rate_limit).post(path, body:, parser:)
+      end
+
+      private
 
-        meter(rate_limit).post(path, body:)
+      def load_types
+        require "peddler/types/easy_ship_2022_03_23"
       end
     end
   end

data/lib/peddler/apis/fba_inbound_eligibility_v1.rb

@@ -17,6 +17,8 @@ module Peddler
     # for inbound shipment to Amazon's fulfillment centers in a specific marketplace. You can also find out if an item
     # is eligible for using the manufacturer barcode for FBA inventory tracking. Sellers can use this information to
     # inform their decisions about which items to ship Amazon's fulfillment centers.
+    #
+    # @see https://github.com/amzn/selling-partner-api-models/blob/main/models/fbaInbound.json
     class FBAInboundEligibilityV1 < API
       # This operation gets an eligibility preview for an item that you specify. You can specify the type of eligibility
       # preview that you want (INBOUND or COMMINGLING). For INBOUND previews, you can specify the marketplace in which
@@ -36,8 +38,14 @@ module Peddler
           "asin" => asin,
           "program" => program,
         }.compact
+        parser = Peddler::Types::FBAInboundEligibilityV1::GetItemEligibilityPreviewResponse if typed?
+        meter(rate_limit).get(path, params:, parser:)
+      end
+
+      private
 
-        meter(rate_limit).get(path, params:)
+      def load_types
+        require "peddler/types/fba_inbound_eligibility_v1"
       end
     end
   end

data/lib/peddler/apis/fba_inventory_v1.rb

@@ -14,18 +14,26 @@ module Peddler
     #
     # The Selling Partner API for FBA Inventory lets you programmatically retrieve information about inventory in
     # Amazon's fulfillment network.
+    #
+    # @see https://github.com/amzn/selling-partner-api-models/blob/main/models/fbaInventory.json
     class FBAInventoryV1 < API
       # Returns a list of inventory summaries. The summaries returned depend on the presence or absence of the
-      # startDateTime, sellerSkus and sellerSku parameters: - All inventory summaries with available details are
-      # returned when the startDateTime, sellerSkus and sellerSku parameters are omitted. - When startDateTime is
-      # provided, the operation returns inventory summaries that have had changes after the date and time specified. The
-      # sellerSkus and sellerSku parameters are ignored. Important: To avoid errors, use both startDateTime and
-      # nextToken to get the next page of inventory summaries that have changed after the date and time specified. -
-      # When the sellerSkus parameter is provided, the operation returns inventory summaries for only the specified
-      # sellerSkus. The sellerSku parameter is ignored. - When the sellerSku parameter is provided, the operation
-      # returns inventory summaries for only the specified sellerSku. 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).
+      # startDateTime, sellerSkus and sellerSku parameters:
+      #
+      # - All inventory summaries with available details are returned when the startDateTime, sellerSkus and sellerSku
+      # parameters are omitted.
+      # - When startDateTime is provided, the operation returns inventory summaries that have had changes after the date
+      # and time specified. The sellerSkus and sellerSku parameters are ignored. Important: To avoid errors, use both
+      # startDateTime and nextToken to get the next page of inventory summaries that have changed after the date and
+      # time specified.
+      # - When the sellerSkus parameter is provided, the operation returns inventory summaries for only the specified
+      # sellerSkus. The sellerSku parameter is ignored.
+      # - When the sellerSku parameter is provided, the operation returns inventory summaries for only the specified
+      # sellerSku.
+      #
+      # 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 dynamic sandbox call.
       # @param details [Boolean] true to return inventory summaries with additional summarized inventory details and
@@ -58,8 +66,8 @@ module Peddler
           "nextToken" => next_token,
           "marketplaceIds" => stringify_array(marketplace_ids),
         }.compact
-
-        meter(rate_limit).get(path, params:)
+        parser = Peddler::Types::FBAInventoryV1::GetInventorySummariesResponse if typed?
+        meter(rate_limit).get(path, params:, parser:)
       end
 
       # Requests that Amazon create product-details in the Sandbox Inventory in the sandbox environment. This is a
@@ -70,12 +78,10 @@ module Peddler
       # @param create_inventory_item_request_body [Hash] CreateInventoryItem Request Body Parameter.
       # @return [Peddler::Response] The API response
       def create_inventory_item(create_inventory_item_request_body)
-        must_sandbox!
-
         path = "/fba/inventory/v1/items"
         body = create_inventory_item_request_body
-
-        post(path, body:)
+        parser = Peddler::Types::FBAInventoryV1::CreateInventoryItemResponse if typed?
+        post(path, body:, parser:)
       end
 
       # Requests that Amazon Deletes an item from the Sandbox Inventory in the sandbox environment. This is a
@@ -87,14 +93,12 @@ module Peddler
       # @param marketplace_id [String] The marketplace ID for the marketplace for which the sellerSku is to be deleted.
       # @return [Peddler::Response] The API response
       def delete_inventory_item(seller_sku, marketplace_id)
-        must_sandbox!
-
         path = "/fba/inventory/v1/items/#{percent_encode(seller_sku)}"
         params = {
           "marketplaceId" => marketplace_id,
         }.compact
-
-        delete(path, params:)
+        parser = Peddler::Types::FBAInventoryV1::DeleteInventoryItemResponse if typed?
+        delete(path, params:, parser:)
       end
 
       # Requests that Amazon add items to the Sandbox Inventory with desired amount of quantity in the sandbox
@@ -107,12 +111,16 @@ module Peddler
       # @param add_inventory_request_body [Hash] List of items to add to Sandbox inventory.
       # @return [Peddler::Response] The API response
       def add_inventory(x_amzn_idempotency_token, add_inventory_request_body)
-        must_sandbox!
-
         path = "/fba/inventory/v1/items/inventory"
         body = add_inventory_request_body
+        parser = Peddler::Types::FBAInventoryV1::AddInventoryResponse if typed?
+        post(path, body:, parser:)
+      end
+
+      private
 
-        post(path, body:)
+      def load_types
+        require "peddler/types/fba_inventory_v1"
       end
     end
   end

data/lib/peddler/apis/feeds_2021_06_30.rb

@@ -14,6 +14,8 @@ module Peddler
     # Selling Partner API for Feeds
     #
     # The Selling Partner API for Feeds lets you upload data to Amazon on behalf of a selling partner.
+    #
+    # @see https://github.com/amzn/selling-partner-api-models/blob/main/models/feeds_2021-06-30.json
     class Feeds20210630 < API
       include Peddler::Helpers::Feeds20210630
 
@@ -49,8 +51,8 @@ module Peddler
           "createdUntil" => created_until,
           "nextToken" => next_token,
         }.compact
-
-        meter(rate_limit).get(path, params:)
+        parser = Peddler::Types::Feeds20210630::GetFeedsResponse if typed?
+        meter(rate_limit).get(path, params:, parser:)
       end
 
       # Creates a feed. Upload the contents of the feed document before calling this operation.
@@ -61,14 +63,13 @@ module Peddler
       # @return [Peddler::Response] The API response
       def create_feed(body, rate_limit: 0.0083)
         path = "/feeds/2021-06-30/feeds"
-
-        meter(rate_limit).post(path, body:)
+        parser = Peddler::Types::Feeds20210630::CreateFeedResponse if typed?
+        meter(rate_limit).post(path, body:, parser:)
       end
 
       # Cancels the feed that you specify. Only feeds with `processingStatus=IN_QUEUE` can be cancelled. Cancelled feeds
-      # are returned in subsequent calls to the
-      # [`getFeed`](https://developer-docs.amazon.com/sp-api/docs/feeds-api-v2021-06-30-reference#getfeed) and
-      # [`getFeeds`](https://developer-docs.amazon.com/sp-api/docs/feeds-api-v2021-06-30-reference#getfeeds) operations.
+      # are returned in subsequent calls to the [`getFeed`](https://developer-docs.amazon.com/sp-api/reference/getfeed)
+      # and [`getFeeds`](https://developer-docs.amazon.com/sp-api/reference/getfeeds) operations.
       #
       # @note This operation can make a static sandbox call.
       # @param feed_id [String] The identifier for the feed. This identifier is unique only in combination with a seller
@@ -77,7 +78,6 @@ module Peddler
       # @return [Peddler::Response] The API response
       def cancel_feed(feed_id, rate_limit: 2.0)
         path = "/feeds/2021-06-30/feeds/#{percent_encode(feed_id)}"
-
         meter(rate_limit).delete(path)
       end
 
@@ -90,14 +90,13 @@ module Peddler
       # @return [Peddler::Response] The API response
       def get_feed(feed_id, rate_limit: 2.0)
         path = "/feeds/2021-06-30/feeds/#{percent_encode(feed_id)}"
-
-        meter(rate_limit).get(path)
+        parser = Peddler::Types::Feeds20210630::Feed if typed?
+        meter(rate_limit).get(path, parser:)
       end
 
       # Creates a feed document for the feed type that you specify. This operation returns a presigned URL for uploading
       # the feed document contents. It also returns a `feedDocumentId` value that you can pass in with a subsequent call
-      # to the [`createFeed`](https://developer-docs.amazon.com/sp-api/docs/feeds-api-v2021-06-30-reference#createfeed)
-      # operation.
+      # to the [`createFeed`](https://developer-docs.amazon.com/sp-api/reference/createfeed) operation.
       #
       # @note This operation can make a static sandbox call.
       # @param body [Hash] Specifies the content type for the createFeedDocument operation.
@@ -105,8 +104,8 @@ module Peddler
       # @return [Peddler::Response] The API response
       def create_feed_document(body, rate_limit: 0.5)
         path = "/feeds/2021-06-30/documents"
-
-        meter(rate_limit).post(path, body:)
+        parser = Peddler::Types::Feeds20210630::CreateFeedDocumentResponse if typed?
+        meter(rate_limit).post(path, body:, parser:)
       end
 
       # Returns the information required for retrieving a feed document's contents.
@@ -117,8 +116,14 @@ module Peddler
       # @return [Peddler::Response] The API response
       def get_feed_document(feed_document_id, rate_limit: 0.0222)
         path = "/feeds/2021-06-30/documents/#{percent_encode(feed_document_id)}"
+        parser = Peddler::Types::Feeds20210630::FeedDocument if typed?
+        meter(rate_limit).get(path, parser:)
+      end
+
+      private
 
-        meter(rate_limit).get(path)
+      def load_types
+        require "peddler/types/feeds_2021_06_30"
       end
     end
   end

data/lib/peddler/apis/finances_2024_06_01.rb

@@ -14,6 +14,8 @@ module Peddler
     #
     # The Selling Partner API for Transfers enables selling partners to retrieve payment methods and initiate payouts
     # for their seller accounts. This API supports the following marketplaces: DE, FR, IT, ES, SE, NL, PL, and BE.
+    #
+    # @see https://github.com/amzn/selling-partner-api-models/blob/main/models/transfers_2024-06-01.json
     class Finances20240601 < API
       # Initiates an on-demand payout to the seller's default deposit method in Seller Central for the given
       # `marketplaceId` and `accountType`, if eligible. You can only initiate one on-demand payout for each marketplace
@@ -25,8 +27,8 @@ module Peddler
       # @return [Peddler::Response] The API response
       def initiate_payout(body, rate_limit: 0.017)
         path = "/finances/transfers/2024-06-01/payouts"
-
-        meter(rate_limit).post(path, body:)
+        parser = Peddler::Types::Finances20240601::InitiatePayoutResponse if typed?
+        meter(rate_limit).post(path, body:, parser:)
       end
 
       # Returns the list of payment methods for the seller, which can be filtered by method type.
@@ -45,8 +47,14 @@ module Peddler
           "marketplaceId" => marketplace_id,
           "paymentMethodTypes" => stringify_array(payment_method_types),
         }.compact
+        parser = Peddler::Types::Finances20240601::GetPaymentMethodsResponse if typed?
+        meter(rate_limit).get(path, params:, parser:)
+      end
+
+      private
 
-        meter(rate_limit).get(path, params:)
+      def load_types
+        require "peddler/types/finances_2024_06_01"
       end
     end
   end

data/lib/peddler/apis/finances_2024_06_19.rb

@@ -15,6 +15,8 @@ module Peddler
     # The Selling Partner API for Finances helps you obtain financial information relevant to a seller's business. You
     # can obtain financial events for a given order or date range without having to wait until a statement period
     # closes.
+    #
+    # @see https://github.com/amzn/selling-partner-api-models/blob/main/models/finances_2024-06-19.json
     class Finances20240619 < API
       # Returns transactions for the given parameters. Financial events might not include orders from the last 48 hours.
       #
@@ -47,8 +49,14 @@ module Peddler
           "transactionStatus" => transaction_status,
           "nextToken" => next_token,
         }.compact
+        parser = Peddler::Types::Finances20240619::ListTransactionsResponse if typed?
+        meter(rate_limit).get(path, params:, parser:)
+      end
+
+      private
 
-        meter(rate_limit).get(path, params:)
+      def load_types
+        require "peddler/types/finances_2024_06_19"
       end
     end
   end