peddler 4.4.0 → 4.6.0

data/lib/peddler/apis/seller_wallet_2024_03_01.rb

@@ -10,62 +10,84 @@ module Peddler
   end
 
   module APIs
-    # The Selling Partner API for Amazon Seller Wallet Open Banking API
+    # The Selling Partner API for Amazon Seller Wallet Open Banking API Spec.
+    #
+    # For more information, refer to the [Seller Wallet Open Banking API Use Case
+    # Guide](doc:seller-wallet-open-banking-api-v2024-03-01-use-case-guide).
     #
     # The Selling Partner API for Seller Wallet (Seller Wallet API) provides financial information that is relevant to a
     # seller's Seller Wallet account. You can obtain financial events, balances, and transfer schedules for Seller
     # Wallet accounts. You can also schedule and initiate transactions.
+    #
+    # @see https://github.com/amzn/selling-partner-api-models/blob/main/models/sellerWallet_2024-03-01.json
     class SellerWallet20240301 < API
-      # Get all Seller Wallet accounts for a given seller.
+      # Get Seller Wallet accounts for a seller.
       #
       # @note This operation can make a static sandbox call.
-      # @param marketplace_id [String] The marketplace for which items are returned. 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 marketplace_id [String] A marketplace identifier. Specifies the marketplace for which items are returned.
       # @return [Peddler::Response] The API response
       def list_accounts(marketplace_id)
         path = "/finances/transfers/wallet/2024-03-01/accounts"
         params = {
           "marketplaceId" => marketplace_id,
         }.compact
-
-        get(path, params:)
+        parser = Peddler::Types::SellerWallet20240301::BankAccountListing if typed?
+        get(path, params:, parser:)
       end
 
-      # Retrieve an Amazon Seller Wallet bank account by Amazon account identifier.
+      # Retrieve a Seller Wallet bank account by Amazon account identifier.
       #
       # @note This operation can make a static sandbox call.
-      # @param account_id [String] The ID of the Amazon Seller Wallet account.
+      # @param account_id [String] ID of the Amazon SW account
+      # @param marketplace_id [String] The marketplace for which items are returned. 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).
       # @return [Peddler::Response] The API response
-      def get_account(account_id)
+      def get_account(account_id, marketplace_id)
         path = "/finances/transfers/wallet/2024-03-01/accounts/#{percent_encode(account_id)}"
-
-        get(path)
+        params = {
+          "marketplaceId" => marketplace_id,
+        }.compact
+        parser = Peddler::Types::SellerWallet20240301::BankAccount if typed?
+        get(path, params:, parser:)
       end
 
-      # Retrieve the balance in a given Amazon Seller Wallet bank account.
+      # Retrieve the balance in a given Seller Wallet bank account.
       #
       # @note This operation can make a static sandbox call.
-      # @param account_id [String] The ID of the Amazon Seller Wallet account.
+      # @param account_id [String] ID of the Amazon SW account
+      # @param marketplace_id [String] The marketplace for which items are returned. 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).
       # @return [Peddler::Response] The API response
-      def list_account_balances(account_id)
+      def list_account_balances(account_id, marketplace_id)
         path = "/finances/transfers/wallet/2024-03-01/accounts/#{percent_encode(account_id)}/balance"
-
-        get(path)
+        params = {
+          "marketplaceId" => marketplace_id,
+        }.compact
+        parser = Peddler::Types::SellerWallet20240301::BalanceListing if typed?
+        get(path, params:, parser:)
       end
 
-      # Retrieve a list of potential fees on a transaction.
+      # Returns list of potential fees on a transaction based on the source and destination country currency code
       #
       # @note This operation can make a static sandbox call.
-      # @param source_country_code [String] Country code of the source transaction account in ISO 3166 format.
-      # @param source_currency_code [String] Currency code of the source transaction country in ISO 4217 format.
-      # @param destination_country_code [String] Country code of the destination transaction account in ISO 3166 format.
-      # @param destination_currency_code [String] Currency code of the destination transaction country in ISO 4217
-      #   format.
-      # @param base_amount [Number] The base transaction amount without any markup fees.
+      # @param source_country_code [String] Represents 2 character country code of source transaction account in ISO
+      #   3166 standard format.
+      # @param source_currency_code [String] Represents 3 letter currency code in ISO 4217 standard format of the source
+      #   transaction country.
+      # @param destination_country_code [String] Represents 2 character country code of destination transaction account
+      #   in ISO 3166 standard format.
+      # @param destination_currency_code [String] Represents 3 letter currency code in ISO 4217 standard format of the
+      #   destination transaction country.
+      # @param base_amount [Number] Represents the base transaction amount without any markup fees, rates that will be
+      #   used to get the transfer preview.
+      # @param marketplace_id [String] The marketplace for which items are returned. 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).
       # @return [Peddler::Response] The API response
       def get_transfer_preview(source_country_code, source_currency_code, destination_country_code,
-        destination_currency_code, base_amount)
+        destination_currency_code, base_amount, marketplace_id)
         path = "/finances/transfers/wallet/2024-03-01/transferPreview"
         params = {
           "sourceCountryCode" => source_country_code,
@@ -73,110 +95,141 @@ module Peddler
           "destinationCountryCode" => destination_country_code,
           "destinationCurrencyCode" => destination_currency_code,
           "baseAmount" => base_amount,
+          "marketplaceId" => marketplace_id,
         }.compact
-
-        get(path, params:)
+        parser = Peddler::Types::SellerWallet20240301::TransferRatePreview if typed?
+        get(path, params:, parser:)
       end
 
-      # Retrieve a list of transactions for a given Amazon Seller Wallet bank account.
+      # Retrieve a list of transactions for a given Seller Wallet bank account.
       #
       # @note This operation can make a static sandbox call.
-      # @param account_id [String] The ID of the Amazon Seller Wallet account.
-      # @param next_page_token [String] A token that you use to retrieve the next page of results. The response includes
-      #   `nextPageToken` when the number of results exceeds 100. 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 `nextPageToken` is null. Note that this operation can return empty pages.
+      # @param account_id [String] ID of the Amazon SW account
+      # @param next_page_token [String] Pagination token to retrieve a specific page of results.
+      # @param marketplace_id [String] The marketplace for which items are returned. 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).
       # @return [Peddler::Response] The API response
-      def list_account_transactions(account_id, next_page_token: nil)
+      def list_account_transactions(account_id, marketplace_id, next_page_token: nil)
         path = "/finances/transfers/wallet/2024-03-01/transactions"
         params = {
           "accountId" => account_id,
           "nextPageToken" => next_page_token,
+          "marketplaceId" => marketplace_id,
         }.compact
-
-        get(path, params:)
+        parser = Peddler::Types::SellerWallet20240301::TransactionListing if typed?
+        get(path, params:, parser:)
       end
 
-      # Create a transaction request from an Amazon Seller Wallet account to another customer-provided account.
+      # Create a transaction request from a Seller Wallet account to another customer-provided account.
       #
       # @note This operation can make a static sandbox call.
-      # @param body [Hash] The payload of the request
+      # @param body [Hash] Defines the actual payload of the request
       # @param dest_account_digital_signature [String] Digital signature for the destination bank account details.
       # @param amount_digital_signature [String] Digital signature for the source currency transaction amount.
+      # @param marketplace_id [String] The marketplace for which items are returned. 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).
       # @return [Peddler::Response] The API response
-      def create_transaction(body, dest_account_digital_signature, amount_digital_signature)
+      def create_transaction(body, dest_account_digital_signature, amount_digital_signature, marketplace_id)
         path = "/finances/transfers/wallet/2024-03-01/transactions"
-
-        post(path, body:)
+        params = {
+          "marketplaceId" => marketplace_id,
+        }.compact
+        parser = Peddler::Types::SellerWallet20240301::CreateTransactionResponse if typed?
+        post(path, body:, params:, parser:)
       end
 
-      # Find a transaction by the Amazon transaction identifier.
+      # Returns a transaction
       #
       # @note This operation can make a static sandbox call.
-      # @param transaction_id [String] The ID of the Amazon Seller Wallet transaction.
+      # @param transaction_id [String] ID of the Amazon SW transaction
+      # @param marketplace_id [String] The marketplace for which items are returned. 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).
       # @return [Peddler::Response] The API response
-      def get_transaction(transaction_id)
+      def get_transaction(transaction_id, marketplace_id)
         path = "/finances/transfers/wallet/2024-03-01/transactions/#{percent_encode(transaction_id)}"
-
-        get(path)
+        params = {
+          "marketplaceId" => marketplace_id,
+        }.compact
+        parser = Peddler::Types::SellerWallet20240301::Transaction if typed?
+        get(path, params:, parser:)
       end
 
-      # Returns all transfer schedules of a given Amazon Seller Wallet bank account with the schedule ID in response if
-      # present.
+      # Retrieve transfer schedules of a Seller Wallet bank account.
       #
       # @note This operation can make a static sandbox call.
-      # @param account_id [String] The ID of the Amazon Seller Wallet account.
-      # @param next_page_token [String] A token that you use to retrieve the next page of results. The response includes
-      #   `nextPageToken` 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 `nextPageToken` is null. Note that this operation can
-      #   return empty pages.
+      # @param account_id [String] ID of the Amazon SW account
+      # @param marketplace_id [String] The marketplace for which items are returned. 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 next_page_token [String] Pagination token to retrieve a specific page of results.
       # @return [Peddler::Response] The API response
-      def list_transfer_schedules(account_id, next_page_token: nil)
+      def list_transfer_schedules(account_id, marketplace_id, next_page_token: nil)
         path = "/finances/transfers/wallet/2024-03-01/transferSchedules"
         params = {
           "accountId" => account_id,
+          "marketplaceId" => marketplace_id,
           "nextPageToken" => next_page_token,
         }.compact
-
-        get(path, params:)
+        parser = Peddler::Types::SellerWallet20240301::TransferScheduleListing if typed?
+        get(path, params:, parser:)
       end
 
-      # Create a transfer schedule request from an Amazon Seller Wallet account to another customer-provided account.
+      # Create a transfer schedule request from a Seller Wallet account to another customer-provided account.
       #
       # @note This operation can make a static sandbox call.
-      # @param body [Hash] The payload of the request.
+      # @param body [Hash] Defines the actual payload of the request
       # @param dest_account_digital_signature [String] Digital signature for the destination bank account details.
       # @param amount_digital_signature [String] Digital signature for the source currency transaction amount.
+      # @param marketplace_id [String] The marketplace for which items are returned. 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).
       # @return [Peddler::Response] The API response
-      def create_transfer_schedule(body, dest_account_digital_signature, amount_digital_signature)
+      def create_transfer_schedule(body, dest_account_digital_signature, amount_digital_signature, marketplace_id)
         path = "/finances/transfers/wallet/2024-03-01/transferSchedules"
-
-        post(path, body:)
+        params = {
+          "marketplaceId" => marketplace_id,
+        }.compact
+        parser = Peddler::Types::SellerWallet20240301::TransferSchedule if typed?
+        post(path, body:, params:, parser:)
       end
 
-      # Update transfer schedule information. Returns a transfer belonging to the updated scheduled transfer request.
+      # Returns a transfer belonging to the updated scheduled transfer request
       #
       # @note This operation can make a static sandbox call.
-      # @param body [Hash] The payload of the scheduled transfer request that is to be updated.
+      # @param body [Hash] Defines the actual payload of the scheduled transfer request that is to be updated.
       # @param dest_account_digital_signature [String] Digital signature for the destination bank account details.
       # @param amount_digital_signature [String] Digital signature for the source currency transaction amount.
+      # @param marketplace_id [String] The marketplace for which items are returned. 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).
       # @return [Peddler::Response] The API response
-      def update_transfer_schedule(body, dest_account_digital_signature, amount_digital_signature)
+      def update_transfer_schedule(body, dest_account_digital_signature, amount_digital_signature, marketplace_id)
         path = "/finances/transfers/wallet/2024-03-01/transferSchedules"
-
-        put(path, body:)
+        params = {
+          "marketplaceId" => marketplace_id,
+        }.compact
+        parser = Peddler::Types::SellerWallet20240301::TransferSchedule if typed?
+        put(path, body:, params:, parser:)
       end
 
       # Find a particular Amazon Seller Wallet account transfer schedule.
       #
       # @note This operation can make a static sandbox call.
       # @param transfer_schedule_id [String] The schedule ID of the Amazon Seller Wallet transfer.
+      # @param marketplace_id [String] The marketplace for which items are returned. 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).
       # @return [Peddler::Response] The API response
-      def get_transfer_schedule(transfer_schedule_id)
+      def get_transfer_schedule(transfer_schedule_id, marketplace_id)
         path = "/finances/transfers/wallet/2024-03-01/transferSchedules/#{percent_encode(transfer_schedule_id)}"
-
-        get(path)
+        params = {
+          "marketplaceId" => marketplace_id,
+        }.compact
+        parser = Peddler::Types::SellerWallet20240301::TransferSchedule if typed?
+        get(path, params:, parser:)
       end
 
       # Delete a transaction request that is scheduled from Amazon Seller Wallet account to another customer-provided
@@ -184,11 +237,23 @@ module Peddler
       #
       # @note This operation can make a static sandbox call.
       # @param transfer_schedule_id [String] A unique reference ID for a scheduled transfer.
+      # @param marketplace_id [String] The marketplace for which items are returned. 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).
       # @return [Peddler::Response] The API response
-      def delete_schedule_transaction(transfer_schedule_id)
+      def delete_schedule_transaction(transfer_schedule_id, marketplace_id)
         path = "/finances/transfers/wallet/2024-03-01/transferSchedules/#{percent_encode(transfer_schedule_id)}"
+        params = {
+          "marketplaceId" => marketplace_id,
+        }.compact
+        parser = Peddler::Types::SellerWallet20240301::DeleteTransferSchedule if typed?
+        delete(path, params:, parser:)
+      end
+
+      private
 
-        delete(path)
+      def load_types
+        require "peddler/types/seller_wallet_2024_03_01"
       end
     end
   end

data/lib/peddler/apis/sellers_v1.rb

@@ -13,10 +13,16 @@ module Peddler
     # The Selling Partner API for Sellers
     #
     # The [Selling Partner API for Sellers](https://developer-docs.amazon.com/sp-api/docs/sellers-api-v1-reference)
-    # (Sellers API) provides essential information about seller accounts, such as: - The marketplaces a seller can list
-    # in - The default language and currency of a marketplace - Whether the seller has suspended listings Refer to the
-    # [Sellers API reference](https://developer-docs.amazon.com/sp-api/docs/sellers-api-v1-reference) for details about
-    # this API's operations, data types, and schemas.
+    # (Sellers API) provides essential information about seller accounts, such as:
+    #
+    # - The marketplaces a seller can list in
+    # - The default language and currency of a marketplace
+    # - Whether the seller has suspended listings
+    #
+    # Refer to the [Sellers API reference](https://developer-docs.amazon.com/sp-api/docs/sellers-api-v1-reference) for
+    # details about this API's operations, data types, and schemas.
+    #
+    # @see https://github.com/amzn/selling-partner-api-models/blob/main/models/sellers.json
     class SellersV1 < API
       # Returns a list of marketplaces where the seller can list items and information about the seller's participation
       # in those marketplaces.
@@ -26,8 +32,8 @@ module Peddler
       # @return [Peddler::Response] The API response
       def get_marketplace_participations(rate_limit: 0.016)
         path = "/sellers/v1/marketplaceParticipations"
-
-        meter(rate_limit).get(path)
+        parser = Peddler::Types::SellersV1::GetMarketplaceParticipationsResponse if typed?
+        meter(rate_limit).get(path, parser:)
       end
 
       # Returns information about a seller account and its marketplaces.
@@ -37,8 +43,14 @@ module Peddler
       # @return [Peddler::Response] The API response
       def get_account(rate_limit: 0.016)
         path = "/sellers/v1/account"
+        parser = Peddler::Types::SellersV1::GetAccountResponse if typed?
+        meter(rate_limit).get(path, parser:)
+      end
+
+      private
 
-        meter(rate_limit).get(path)
+      def load_types
+        require "peddler/types/sellers_v1"
       end
     end
   end

data/lib/peddler/apis/services_v1.rb

@@ -14,6 +14,8 @@ module Peddler
     #
     # With the Services API, you can build applications that help service providers get and modify their service orders
     # and manage their resources.
+    #
+    # @see https://github.com/amzn/selling-partner-api-models/blob/main/models/services.json
     class ServicesV1 < API
       # Gets details of service job indicated by the provided `serviceJobID`.
       #
@@ -23,8 +25,8 @@ module Peddler
       # @return [Peddler::Response] The API response
       def get_service_job_by_service_job_id(service_job_id, rate_limit: 20.0)
         path = "/service/v1/serviceJobs/#{percent_encode(service_job_id)}"
-
-        meter(rate_limit).get(path)
+        parser = Peddler::Types::ServicesV1::GetServiceJobByServiceJobIdResponse if typed?
+        meter(rate_limit).get(path, parser:)
       end
 
       # Cancels the service job indicated by the service job identifier specified.
@@ -40,8 +42,8 @@ module Peddler
         params = {
           "cancellationReasonCode" => cancellation_reason_code,
         }.compact
-
-        meter(rate_limit).put(path, params:)
+        parser = Peddler::Types::ServicesV1::CancelServiceJobByServiceJobIdResponse if typed?
+        meter(rate_limit).put(path, params:, parser:)
       end
 
       # Completes the service job indicated by the service job identifier specified.
@@ -52,8 +54,8 @@ module Peddler
       # @return [Peddler::Response] The API response
       def complete_service_job_by_service_job_id(service_job_id, rate_limit: 5.0)
         path = "/service/v1/serviceJobs/#{percent_encode(service_job_id)}/completions"
-
-        meter(rate_limit).put(path)
+        parser = Peddler::Types::ServicesV1::CompleteServiceJobByServiceJobIdResponse if typed?
+        meter(rate_limit).put(path, parser:)
       end
 
       # Gets service job details for the specified filter query.
@@ -114,8 +116,8 @@ module Peddler
           "requiredSkills" => stringify_array(required_skills),
           "storeIds" => stringify_array(store_ids),
         }.compact
-
-        meter(rate_limit).get(path, params:)
+        parser = Peddler::Types::ServicesV1::GetServiceJobsResponse if typed?
+        meter(rate_limit).get(path, params:, parser:)
       end
 
       # Adds an appointment to the service job indicated by the service job identifier specified.
@@ -127,8 +129,8 @@ module Peddler
       # @return [Peddler::Response] The API response
       def add_appointment_for_service_job_by_service_job_id(service_job_id, body, rate_limit: 5.0)
         path = "/service/v1/serviceJobs/#{percent_encode(service_job_id)}/appointments"
-
-        meter(rate_limit).post(path, body:)
+        parser = Peddler::Types::ServicesV1::SetAppointmentResponse if typed?
+        meter(rate_limit).post(path, body:, parser:)
       end
 
       # Reschedules an appointment for the service job indicated by the service job identifier specified.
@@ -142,8 +144,8 @@ module Peddler
       def reschedule_appointment_for_service_job_by_service_job_id(service_job_id, appointment_id, body,
         rate_limit: 5.0)
         path = "/service/v1/serviceJobs/#{percent_encode(service_job_id)}/appointments/#{percent_encode(appointment_id)}"
-
-        meter(rate_limit).post(path, body:)
+        parser = Peddler::Types::ServicesV1::SetAppointmentResponse if typed?
+        meter(rate_limit).post(path, body:, parser:)
       end
 
       # Assigns new resource(s) or overwrite/update the existing one(s) to a service job appointment.
@@ -157,8 +159,8 @@ module Peddler
       # @return [Peddler::Response] The API response
       def assign_appointment_resources(service_job_id, appointment_id, body, rate_limit: 1.0)
         path = "/service/v1/serviceJobs/#{percent_encode(service_job_id)}/appointments/#{percent_encode(appointment_id)}/resources"
-
-        meter(rate_limit).put(path, body:)
+        parser = Peddler::Types::ServicesV1::AssignAppointmentResourcesResponse if typed?
+        meter(rate_limit).put(path, body:, parser:)
       end
 
       # Updates the appointment fulfillment data related to a given `jobID` and `appointmentID`.
@@ -172,7 +174,6 @@ module Peddler
       # @return [Peddler::Response] The API response
       def set_appointment_fulfillment_data(service_job_id, appointment_id, body, rate_limit: 5.0)
         path = "/service/v1/serviceJobs/#{percent_encode(service_job_id)}/appointments/#{percent_encode(appointment_id)}/fulfillment"
-
         meter(rate_limit).put(path, body:)
       end
 
@@ -191,8 +192,8 @@ module Peddler
           "marketplaceIds" => stringify_array(marketplace_ids),
           "nextPageToken" => next_page_token,
         }.compact
-
-        meter(rate_limit).post(path, body:, params:)
+        parser = Peddler::Types::ServicesV1::RangeSlotCapacity if typed?
+        meter(rate_limit).post(path, body:, params:, parser:)
       end
 
       # Provides capacity in fixed-size slots.
@@ -210,8 +211,8 @@ module Peddler
           "marketplaceIds" => stringify_array(marketplace_ids),
           "nextPageToken" => next_page_token,
         }.compact
-
-        meter(rate_limit).post(path, body:, params:)
+        parser = Peddler::Types::ServicesV1::FixedSlotCapacity if typed?
+        meter(rate_limit).post(path, body:, params:, parser:)
       end
 
       # Update the schedule of the given resource.
@@ -227,8 +228,8 @@ module Peddler
         params = {
           "marketplaceIds" => stringify_array(marketplace_ids),
         }.compact
-
-        meter(rate_limit).put(path, body:, params:)
+        parser = Peddler::Types::ServicesV1::UpdateScheduleResponse if typed?
+        meter(rate_limit).put(path, body:, params:, parser:)
       end
 
       # Create a reservation.
@@ -243,8 +244,8 @@ module Peddler
         params = {
           "marketplaceIds" => stringify_array(marketplace_ids),
         }.compact
-
-        meter(rate_limit).post(path, body:, params:)
+        parser = Peddler::Types::ServicesV1::CreateReservationResponse if typed?
+        meter(rate_limit).post(path, body:, params:, parser:)
       end
 
       # Update a reservation.
@@ -260,8 +261,8 @@ module Peddler
         params = {
           "marketplaceIds" => stringify_array(marketplace_ids),
         }.compact
-
-        meter(rate_limit).put(path, body:, params:)
+        parser = Peddler::Types::ServicesV1::UpdateReservationResponse if typed?
+        meter(rate_limit).put(path, body:, params:, parser:)
       end
 
       # Cancel a reservation.
@@ -276,8 +277,8 @@ module Peddler
         params = {
           "marketplaceIds" => stringify_array(marketplace_ids),
         }.compact
-
-        meter(rate_limit).delete(path, params:)
+        parser = Peddler::Types::ServicesV1::CancelReservationResponse if typed?
+        meter(rate_limit).delete(path, params:, parser:)
       end
 
       # Gets appointment slots for the service associated with the service job id specified.
@@ -301,8 +302,8 @@ module Peddler
           "startTime" => start_time,
           "endTime" => end_time,
         }.compact
-
-        meter(rate_limit).get(path, params:)
+        parser = Peddler::Types::ServicesV1::GetAppointmentSlotsResponse if typed?
+        meter(rate_limit).get(path, params:, parser:)
       end
 
       # Gets appointment slots as per the service context specified.
@@ -328,8 +329,8 @@ module Peddler
           "startTime" => start_time,
           "endTime" => end_time,
         }.compact
-
-        meter(rate_limit).get(path, params:)
+        parser = Peddler::Types::ServicesV1::GetAppointmentSlotsResponse if typed?
+        meter(rate_limit).get(path, params:, parser:)
       end
 
       # Creates an upload destination.
@@ -340,8 +341,14 @@ module Peddler
       # @return [Peddler::Response] The API response
       def create_service_document_upload_destination(body, rate_limit: 5.0)
         path = "/service/v1/documents"
+        parser = Peddler::Types::ServicesV1::CreateServiceDocumentUploadDestination if typed?
+        meter(rate_limit).post(path, body:, parser:)
+      end
+
+      private
 
-        meter(rate_limit).post(path, body:)
+      def load_types
+        require "peddler/types/services_v1"
       end
     end
   end

data/lib/peddler/apis/shipment_invoicing_v0.rb

@@ -14,6 +14,8 @@ module Peddler
     #
     # The Selling Partner API for Shipment Invoicing helps you programmatically retrieve shipment invoice information in
     # the Brazil marketplace for a selling partner’s Fulfillment by Amazon (FBA) orders.
+    #
+    # @see https://github.com/amzn/selling-partner-api-models/blob/main/models/shipmentInvoicingV0.json
     class ShipmentInvoicingV0 < API
       # Returns the shipment details required to issue an invoice for the specified shipment.
       #
@@ -26,8 +28,8 @@ module Peddler
       # @return [Peddler::Response] The API response
       def get_shipment_details(shipment_id, rate_limit: 1.133)
         path = "/fba/outbound/brazil/v0/shipments/#{percent_encode(shipment_id)}"
-
-        meter(rate_limit).get(path)
+        parser = Peddler::Types::ShipmentInvoicingV0::GetShipmentDetailsResponse if typed?
+        meter(rate_limit).get(path, parser:)
       end
 
       # Submits a shipment invoice document for a given shipment.
@@ -39,8 +41,8 @@ module Peddler
       # @return [Peddler::Response] The API response
       def submit_invoice(shipment_id, body, rate_limit: 1.133)
         path = "/fba/outbound/brazil/v0/shipments/#{percent_encode(shipment_id)}/invoice"
-
-        meter(rate_limit).post(path, body:)
+        parser = Peddler::Types::ShipmentInvoicingV0::SubmitInvoiceResponse if typed?
+        meter(rate_limit).post(path, body:, parser:)
       end
 
       # Returns the invoice status for the shipment you specify.
@@ -51,8 +53,14 @@ module Peddler
       # @return [Peddler::Response] The API response
       def get_invoice_status(shipment_id, rate_limit: 1.133)
         path = "/fba/outbound/brazil/v0/shipments/#{percent_encode(shipment_id)}/invoice/status"
+        parser = Peddler::Types::ShipmentInvoicingV0::GetInvoiceStatusResponse if typed?
+        meter(rate_limit).get(path, parser:)
+      end
+
+      private
 
-        meter(rate_limit).get(path)
+      def load_types
+        require "peddler/types/shipment_invoicing_v0"
       end
     end
   end