peddler 4.4.0 → 4.6.0

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,32 +15,48 @@ 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. It may take up to 48 hours for transactions to appear in your
-      # transaction events.
+      # Returns transactions for the given parameters. Financial events might not include orders from the last 48 hours.
       #
       # @note This operation can make a static sandbox call.
-      # @param posted_after [String] A date used for selecting transactions posted after (or at) a specified time. The
-      #   date-time must be no later than two minutes before the request was submitted, in ISO 8601 date time format.
+      # @param posted_after [String] The response includes financial events posted on or after this date. This date must
+      #   be in [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) date-time format. The date-time must
+      #   be more than two minutes before the time of the request.
       # @param posted_before [String] A date used for selecting transactions posted before (but not at) a specified
       #   time. The date-time must be later than PostedAfter and no later than two minutes before the request was
       #   submitted, in ISO 8601 date time format. If PostedAfter and PostedBefore are more than 180 days apart, no
       #   transactions are returned. You must specify the PostedAfter parameter if you specify the PostedBefore
       #   parameter. Default: Now minus two minutes.
-      # @param marketplace_id [String] A string token used to select Marketplace ID.
+      # @param marketplace_id [String] The identifier of the marketplace from which you want to retrieve transactions.
+      #   The marketplace ID is the globally unique identifier of a marketplace. To find the ID for your marketplace,
+      #   refer to [Marketplace IDs](https://developer-docs.amazon.com/sp-api/docs/marketplace-ids).
+      # @param transaction_status [String] The status of the transaction. **Possible values:** * `DEFERRED`: the
+      #   transaction is currently deferred. * `RELEASED`: the transaction is currently released. * `DEFERRED_RELEASED`:
+      #   the transaction was deferred in the past, but is now released. The status of a deferred transaction is updated
+      #   to `DEFERRED_RELEASED` when the transaction is released.
       # @param next_token [String] A string token returned in the response of your previous request.
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
-      def list_transactions(posted_after, posted_before: nil, marketplace_id: nil, next_token: nil, rate_limit: 0.5)
+      def list_transactions(posted_after, posted_before: nil, marketplace_id: nil, transaction_status: nil,
+        next_token: nil, rate_limit: 0.5)
         path = "/finances/2024-06-19/transactions"
         params = {
           "postedAfter" => posted_after,
           "postedBefore" => posted_before,
           "marketplaceId" => marketplace_id,
+          "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

data/lib/peddler/apis/finances_v0.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, financial event group, or date range without having to wait until a
     # statement period closes. You can also obtain financial event groups for a given date range.
+    #
+    # @see https://github.com/amzn/selling-partner-api-models/blob/main/models/financesV0.json
     class FinancesV0 < API
       # Returns financial event groups for a given date range. It may take up to 48 hours for orders to appear in your
       # financial events.
@@ -43,13 +45,15 @@ module Peddler
           "FinancialEventGroupStartedAfter" => financial_event_group_started_after,
           "NextToken" => next_token,
         }.compact
-
-        meter(rate_limit).get(path, params:)
+        parser = Peddler::Types::FinancesV0::ListFinancialEventGroupsResponse if typed?
+        meter(rate_limit).get(path, params:, parser:)
       end
 
       # Returns all financial events for the specified financial event group. It may take up to 48 hours for orders to
-      # appear in your financial events. **Note:** This operation will only retrieve group's data for the past two
-      # years. If a request is submitted for data spanning more than two years, an empty response is returned.
+      # appear in your financial events.
+      #
+      # **Note:** This operation will only retrieve group's data for the past two years. If a request is submitted for
+      # data spanning more than two years, an empty response is returned.
       #
       # @note This operation can make a static sandbox call.
       # @param max_results_per_page [Integer] The maximum number of results to return per page. If the response exceeds
@@ -76,8 +80,8 @@ module Peddler
           "PostedBefore" => posted_before,
           "NextToken" => next_token,
         }.compact
-
-        meter(rate_limit).get(path, params:)
+        parser = Peddler::Types::FinancesV0::ListFinancialEventsResponse if typed?
+        meter(rate_limit).get(path, params:, parser:)
       end
 
       # Returns all financial events for the specified order. It may take up to 48 hours for orders to appear in your
@@ -96,13 +100,14 @@ module Peddler
           "MaxResultsPerPage" => max_results_per_page,
           "NextToken" => next_token,
         }.compact
-
-        meter(rate_limit).get(path, params:)
+        parser = Peddler::Types::FinancesV0::ListFinancialEventsResponse if typed?
+        meter(rate_limit).get(path, params:, parser:)
       end
 
       # Returns financial events for the specified data range. It may take up to 48 hours for orders to appear in your
-      # financial events. **Note:** in `ListFinancialEvents`, deferred events don't show up in responses until in they
-      # are released.
+      # financial events.
+      #
+      # **Note:** in `ListFinancialEvents`, deferred events don't show up in responses until in they are released.
       #
       # @note This operation can make a static sandbox call.
       # @param max_results_per_page [Integer] The maximum number of results to return per page. If the response exceeds
@@ -127,8 +132,14 @@ module Peddler
           "PostedBefore" => posted_before,
           "NextToken" => next_token,
         }.compact
+        parser = Peddler::Types::FinancesV0::ListFinancialEventsResponse if typed?
+        meter(rate_limit).get(path, params:, parser:)
+      end
+
+      private
 
-        meter(rate_limit).get(path, params:)
+      def load_types
+        require "peddler/types/finances_v0"
       end
     end
   end