peddler 4.1.1 → 4.3.0

data/lib/peddler/apis/messaging_v1.rb

@@ -24,8 +24,8 @@ module Peddler
       # @note This operation can make a static sandbox call.
       # @param amazon_order_id [String] An Amazon order identifier. This specifies the order for which you want a list
       #   of available message types.
-      # @param marketplace_ids [Array<String>] A marketplace identifier. This specifies the marketplace in which the
-      #   order was placed. Only one marketplace can be specified.
+      # @param marketplace_ids [Array<String>] A marketplace identifier. This identifies the marketplace in which the
+      #   order was placed. You can only specify one marketplace.
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def get_messaging_actions_for_order(amazon_order_id, marketplace_ids, rate_limit: 1.0)
@@ -41,11 +41,11 @@ module Peddler
       # initials, etc.
       #
       # @note This operation can make a static sandbox call.
-      # @param amazon_order_id [String] An Amazon order identifier. This specifies the order for which a message is
+      # @param amazon_order_id [String] An Amazon order identifier. This identifies the order for which a message is
       #   sent.
-      # @param marketplace_ids [Array<String>] A marketplace identifier. This specifies the marketplace in which the
-      #   order was placed. Only one marketplace can be specified.
-      # @param body [Hash]
+      # @param marketplace_ids [Array<String>] A marketplace identifier. This identifies the marketplace in which the
+      #   order was placed. You can only specify one marketplace.
+      # @param body [Hash] This contains the message body for a message.
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def confirm_customization_details(amazon_order_id, marketplace_ids, body, rate_limit: 1.0)
@@ -60,11 +60,11 @@ module Peddler
       # Sends a message to a buyer to arrange a delivery or to confirm contact information for making a delivery.
       #
       # @note This operation can make a static sandbox call.
-      # @param amazon_order_id [String] An Amazon order identifier. This specifies the order for which a message is
+      # @param amazon_order_id [String] An Amazon order identifier. This identifies the order for which a message is
       #   sent.
-      # @param marketplace_ids [Array<String>] A marketplace identifier. This specifies the marketplace in which the
-      #   order was placed. Only one marketplace can be specified.
-      # @param body [Hash]
+      # @param marketplace_ids [Array<String>] A marketplace identifier. This identifies the marketplace in which the
+      #   order was placed. You can only specify one marketplace.
+      # @param body [Hash] This contains the message body for a message.
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def create_confirm_delivery_details(amazon_order_id, marketplace_ids, body, rate_limit: 1.0)
@@ -80,11 +80,11 @@ module Peddler
       # This message should only be used to deliver documents that are required by law.
       #
       # @note This operation can make a static sandbox call.
-      # @param amazon_order_id [String] An Amazon order identifier. This specifies the order for which a message is
+      # @param amazon_order_id [String] An Amazon order identifier. This identifies the order for which a message is
       #   sent.
-      # @param marketplace_ids [Array<String>] A marketplace identifier. This specifies the marketplace in which the
-      #   order was placed. Only one marketplace can be specified.
-      # @param body [Hash]
+      # @param marketplace_ids [Array<String>] A marketplace identifier. This identifies the marketplace in which the
+      #   order was placed. You can only specify one marketplace.
+      # @param body [Hash] This contains the message body for a message.
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def create_legal_disclosure(amazon_order_id, marketplace_ids, body, rate_limit: 1.0)
@@ -100,10 +100,10 @@ module Peddler
       # sent after the seller has resolved the buyer's problem.
       #
       # @note This operation can make a static sandbox call.
-      # @param amazon_order_id [String] An Amazon order identifier. This specifies the order for which a message is
+      # @param amazon_order_id [String] An Amazon order identifier. This identifies the order for which a message is
       #   sent.
-      # @param marketplace_ids [Array<String>] A marketplace identifier. This specifies the marketplace in which the
-      #   order was placed. Only one marketplace can be specified.
+      # @param marketplace_ids [Array<String>] A marketplace identifier. This identifies the marketplace in which the
+      #   order was placed. You can only specify one marketplace.
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def create_negative_feedback_removal(amazon_order_id, marketplace_ids, rate_limit: 1.0)
@@ -118,11 +118,11 @@ module Peddler
       # Sends a message to ask a buyer an order-related question prior to shipping their order.
       #
       # @note This operation can make a static sandbox call.
-      # @param amazon_order_id [String] An Amazon order identifier. This specifies the order for which a message is
+      # @param amazon_order_id [String] An Amazon order identifier. This identifies the order for which a message is
       #   sent.
-      # @param marketplace_ids [Array<String>] A marketplace identifier. This specifies the marketplace in which the
-      #   order was placed. Only one marketplace can be specified.
-      # @param body [Hash]
+      # @param marketplace_ids [Array<String>] A marketplace identifier. This identifies the marketplace in which the
+      #   order was placed. You can only specify one marketplace.
+      # @param body [Hash] This contains the message body for a message.
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def create_confirm_order_details(amazon_order_id, marketplace_ids, body, rate_limit: 1.0)
@@ -138,11 +138,11 @@ module Peddler
       # service call.
       #
       # @note This operation can make a static sandbox call.
-      # @param amazon_order_id [String] An Amazon order identifier. This specifies the order for which a message is
+      # @param amazon_order_id [String] An Amazon order identifier. This identifies the order for which a message is
       #   sent.
-      # @param marketplace_ids [Array<String>] A marketplace identifier. This specifies the marketplace in which the
-      #   order was placed. Only one marketplace can be specified.
-      # @param body [Hash]
+      # @param marketplace_ids [Array<String>] A marketplace identifier. This identifies the marketplace in which the
+      #   order was placed. You can only specify one marketplace.
+      # @param body [Hash] This contains the message body for a message.
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def create_confirm_service_details(amazon_order_id, marketplace_ids, body, rate_limit: 1.0)
@@ -158,11 +158,11 @@ module Peddler
       # Amazon Motors sellers.
       #
       # @note This operation can make a static sandbox call.
-      # @param amazon_order_id [String] An Amazon order identifier. This specifies the order for which a message is
+      # @param amazon_order_id [String] An Amazon order identifier. This identifies the order for which a message is
       #   sent.
-      # @param marketplace_ids [Array<String>] A marketplace identifier. This specifies the marketplace in which the
-      #   order was placed. Only one marketplace can be specified.
-      # @param body [Hash]
+      # @param marketplace_ids [Array<String>] A marketplace identifier. This identifies the marketplace in which the
+      #   order was placed. You can only specify one marketplace.
+      # @param body [Hash] This contains the message body for a message.
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def create_amazon_motors(amazon_order_id, marketplace_ids, body, rate_limit: 1.0)
@@ -177,11 +177,11 @@ module Peddler
       # Sends a message to a buyer to provide details about warranty information on a purchase in their order.
       #
       # @note This operation can make a static sandbox call.
-      # @param amazon_order_id [String] An Amazon order identifier. This specifies the order for which a message is
+      # @param amazon_order_id [String] An Amazon order identifier. This identifies the order for which a message is
       #   sent.
-      # @param marketplace_ids [Array<String>] A marketplace identifier. This specifies the marketplace in which the
-      #   order was placed. Only one marketplace can be specified.
-      # @param body [Hash]
+      # @param marketplace_ids [Array<String>] A marketplace identifier. This identifies the marketplace in which the
+      #   order was placed. You can only specify one marketplace.
+      # @param body [Hash] This contains the message body for a message.
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def create_warranty(amazon_order_id, marketplace_ids, body, rate_limit: 1.0)
@@ -196,10 +196,10 @@ module Peddler
       # Returns a response containing attributes related to an order. This includes buyer preferences.
       #
       # @note This operation can make a static sandbox call.
-      # @param amazon_order_id [String] An Amazon order identifier. This specifies the order for which a message is
+      # @param amazon_order_id [String] An Amazon order identifier. This identifies the order for which a message is
       #   sent.
-      # @param marketplace_ids [Array<String>] A marketplace identifier. This specifies the marketplace in which the
-      #   order was placed. Only one marketplace can be specified.
+      # @param marketplace_ids [Array<String>] A marketplace identifier. This identifies the marketplace in which the
+      #   order was placed. You can only specify one marketplace.
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def get_attributes(amazon_order_id, marketplace_ids, rate_limit: 1.0)
@@ -211,14 +211,15 @@ module Peddler
         meter(rate_limit).get(path, params:)
       end
 
-      # Sends a message to a buyer to share a digital access key needed to utilize digital content in their order.
+      # Sends a buyer a message to share a digital access key that is required to utilize digital content in their
+      # order.
       #
       # @note This operation can make a static sandbox call.
-      # @param amazon_order_id [String] An Amazon order identifier. This specifies the order for which a message is
+      # @param amazon_order_id [String] An Amazon order identifier. This identifies the order for which a message is
       #   sent.
-      # @param marketplace_ids [Array<String>] A marketplace identifier. This specifies the marketplace in which the
-      #   order was placed. Only one marketplace can be specified.
-      # @param body [Hash]
+      # @param marketplace_ids [Array<String>] A marketplace identifier. This identifies the marketplace in which the
+      #   order was placed. You can only specify one marketplace.
+      # @param body [Hash] This contains the message body for a message.
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def create_digital_access_key(amazon_order_id, marketplace_ids, body, rate_limit: 1.0)
@@ -234,11 +235,11 @@ module Peddler
       # order.
       #
       # @note This operation can make a static sandbox call.
-      # @param amazon_order_id [String] An Amazon order identifier. This specifies the order for which a message is
+      # @param amazon_order_id [String] An Amazon order identifier. This identifies the order for which a message is
       #   sent.
-      # @param marketplace_ids [Array<String>] A marketplace identifier. This specifies the marketplace in which the
-      #   order was placed. Only one marketplace can be specified.
-      # @param body [Hash]
+      # @param marketplace_ids [Array<String>] A marketplace identifier. This identifies the marketplace in which the
+      #   order was placed. You can only specify one marketplace.
+      # @param body [Hash] This contains the message body for a message.
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def create_unexpected_problem(amazon_order_id, marketplace_ids, body, rate_limit: 1.0)
@@ -253,11 +254,11 @@ module Peddler
       # Sends a message providing the buyer an invoice
       #
       # @note This operation can make a static sandbox call.
-      # @param amazon_order_id [String] An Amazon order identifier. This specifies the order for which a message is
+      # @param amazon_order_id [String] An Amazon order identifier. This identifies the order for which a message is
       #   sent.
-      # @param marketplace_ids [Array<String>] A marketplace identifier. This specifies the marketplace in which the
-      #   order was placed. Only one marketplace can be specified.
-      # @param body [Hash]
+      # @param marketplace_ids [Array<String>] A marketplace identifier. This identifies the marketplace in which the
+      #   order was placed. You can only specify one marketplace.
+      # @param body [Hash] This contains the message body for a message.
       # @return [Peddler::Response] The API response
       def send_invoice(amazon_order_id, marketplace_ids, body)
         path = "/messaging/v1/orders/#{amazon_order_id}/messages/invoice"

data/lib/peddler/apis/orders_v0.rb

@@ -10,7 +10,7 @@ module Peddler
   end
 
   module APIs
-    # Orders v0
+    # Selling Partner API for Orders
     #
     # Use the Orders Selling Partner API to programmatically retrieve order information. With this API, you can develop
     # fast, flexible, and custom applications to manage order synchronization, perform order research, and create

data/lib/peddler/apis/product_pricing_v0.rb

@@ -135,7 +135,7 @@ module Peddler
       # Returns the lowest priced offers for a batch of items based on ASIN.
       #
       # @note This operation can make a static sandbox call.
-      # @param get_item_offers_batch_request_body [Hash]
+      # @param get_item_offers_batch_request_body [Hash] The request associated with the `getItemOffersBatch` API call.
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def get_item_offers_batch(get_item_offers_batch_request_body, rate_limit: 0.1)
@@ -148,7 +148,8 @@ module Peddler
       # Returns the lowest priced offers for a batch of listings by SKU.
       #
       # @note This operation can make a static sandbox call.
-      # @param get_listing_offers_batch_request_body [Hash]
+      # @param get_listing_offers_batch_request_body [Hash] The request associated with the `getListingOffersBatch` API
+      #   call.
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def get_listing_offers_batch(get_listing_offers_batch_request_body, rate_limit: 0.5)

data/lib/peddler/apis/reports_2021_06_30.rb

@@ -10,7 +10,7 @@ module Peddler
   end
 
   module APIs
-    # Report v2021-06-30
+    # Selling Partner API for Reports
     #
     # The Selling Partner API for Reports lets you retrieve and manage a variety of reports that can help selling
     # partners manage their businesses.

data/lib/peddler/apis/seller_wallet_2024_03_01.rb

@@ -0,0 +1,195 @@
+# frozen_string_literal: true
+
+require "peddler/api"
+
+module Peddler
+  class << self
+    def seller_wallet_2024_03_01(...)
+      APIs::SellerWallet20240301.new(...)
+    end
+  end
+
+  module APIs
+    # The Selling Partner API for Amazon Seller Wallet Open Banking API
+    #
+    # 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.
+    class SellerWallet20240301 < API
+      # Get all Seller Wallet accounts for a given 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).
+      # @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:)
+      end
+
+      # Retrieve an Amazon 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.
+      # @return [Peddler::Response] The API response
+      def get_account(account_id)
+        path = "/finances/transfers/wallet/2024-03-01/accounts/#{account_id}"
+
+        get(path)
+      end
+
+      # Retrieve the balance in a given Amazon 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.
+      # @return [Peddler::Response] The API response
+      def list_account_balances(account_id)
+        path = "/finances/transfers/wallet/2024-03-01/accounts/#{account_id}/balance"
+
+        get(path)
+      end
+
+      # Retrieve a list of potential fees on a transaction.
+      #
+      # @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.
+      # @return [Peddler::Response] The API response
+      def get_transfer_preview(source_country_code, source_currency_code, destination_country_code,
+        destination_currency_code, base_amount)
+        path = "/finances/transfers/wallet/2024-03-01/transferPreview"
+        params = {
+          "sourceCountryCode" => source_country_code,
+          "sourceCurrencyCode" => source_currency_code,
+          "destinationCountryCode" => destination_country_code,
+          "destinationCurrencyCode" => destination_currency_code,
+          "baseAmount" => base_amount,
+        }.compact
+
+        get(path, params:)
+      end
+
+      # Retrieve a list of transactions for a given Amazon 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.
+      # @return [Peddler::Response] The API response
+      def list_account_transactions(account_id, next_page_token: nil)
+        path = "/finances/transfers/wallet/2024-03-01/transactions"
+        params = {
+          "accountId" => account_id,
+          "nextPageToken" => next_page_token,
+        }.compact
+
+        get(path, params:)
+      end
+
+      # Create a transaction request from an Amazon 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 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.
+      # @return [Peddler::Response] The API response
+      def create_transaction(body, dest_account_digital_signature, amount_digital_signature)
+        path = "/finances/transfers/wallet/2024-03-01/transactions"
+
+        post(path, body:)
+      end
+
+      # Find a transaction by the Amazon transaction identifier.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param transaction_id [String] The ID of the Amazon Seller Wallet transaction.
+      # @return [Peddler::Response] The API response
+      def get_transaction(transaction_id)
+        path = "/finances/transfers/wallet/2024-03-01/transactions/#{transaction_id}"
+
+        get(path)
+      end
+
+      # Returns all transfer schedules of a given Amazon Seller Wallet bank account with the schedule ID in response if
+      # present.
+      #
+      # @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.
+      # @return [Peddler::Response] The API response
+      def list_transfer_schedules(account_id, next_page_token: nil)
+        path = "/finances/transfers/wallet/2024-03-01/transferSchedules"
+        params = {
+          "accountId" => account_id,
+          "nextPageToken" => next_page_token,
+        }.compact
+
+        get(path, params:)
+      end
+
+      # Create a transfer schedule request from an Amazon 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 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.
+      # @return [Peddler::Response] The API response
+      def create_transfer_schedule(body, dest_account_digital_signature, amount_digital_signature)
+        path = "/finances/transfers/wallet/2024-03-01/transferSchedules"
+
+        post(path, body:)
+      end
+
+      # Update transfer schedule information. 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 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.
+      # @return [Peddler::Response] The API response
+      def update_transfer_schedule(body, dest_account_digital_signature, amount_digital_signature)
+        path = "/finances/transfers/wallet/2024-03-01/transferSchedules"
+
+        put(path, body:)
+      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.
+      # @return [Peddler::Response] The API response
+      def get_transfer_schedule(transfer_schedule_id)
+        path = "/finances/transfers/wallet/2024-03-01/transferSchedules/#{transfer_schedule_id}"
+
+        get(path)
+      end
+
+      # Delete a transaction request that is scheduled from Amazon Seller Wallet account to another customer-provided
+      # account.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param transfer_schedule_id [String] A unique reference ID for a scheduled transfer.
+      # @return [Peddler::Response] The API response
+      def delete_schedule_transaction(transfer_schedule_id)
+        path = "/finances/transfers/wallet/2024-03-01/transferSchedules/#{transfer_schedule_id}"
+
+        delete(path)
+      end
+    end
+  end
+end

data/lib/peddler/apis/sellers_v1.rb

@@ -10,7 +10,7 @@ module Peddler
   end
 
   module APIs
-    # Selling Partner API for Sellers
+    # 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

data/lib/peddler/apis/shipping_v1.rb

@@ -21,7 +21,7 @@ module Peddler
       # Create a new shipment.
       #
       # @note This operation can make a static sandbox call.
-      # @param body [Hash]
+      # @param body [Hash] CreateShipmentRequest Body
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def create_shipment(body, rate_limit: 5.0)
@@ -33,7 +33,7 @@ module Peddler
       # Return the entire shipment object for the shipmentId.
       #
       # @note This operation can make a static sandbox call.
-      # @param shipment_id [String]
+      # @param shipment_id [String] Shipment id to return the entire shipment object
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def get_shipment(shipment_id, rate_limit: 5.0)
@@ -45,7 +45,7 @@ module Peddler
       # Cancel a shipment by the given shipmentId.
       #
       # @note This operation can make a static sandbox call.
-      # @param shipment_id [String]
+      # @param shipment_id [String] Shipment Id to cancel a shipment
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def cancel_shipment(shipment_id, rate_limit: 5.0)
@@ -57,8 +57,8 @@ module Peddler
       # Purchase shipping labels based on a given rate.
       #
       # @note This operation can make a static sandbox call.
-      # @param shipment_id [String]
-      # @param body [Hash]
+      # @param shipment_id [String] Shipment id for purchase shipping label
+      # @param body [Hash] PurchaseShippingLabelRequest body
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def purchase_labels(shipment_id, body, rate_limit: 5.0)
@@ -70,9 +70,9 @@ module Peddler
       # Retrieve shipping label based on the shipment id and tracking id.
       #
       # @note This operation can make a static sandbox call.
-      # @param shipment_id [String]
-      # @param tracking_id [String]
-      # @param body [Hash]
+      # @param shipment_id [String] Shipment Id to retreive label
+      # @param tracking_id [String] Tracking Id
+      # @param body [Hash] RetrieveShippingLabelRequest body
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def retrieve_shipping_label(shipment_id, tracking_id, body, rate_limit: 5.0)
@@ -84,7 +84,7 @@ module Peddler
       # Purchase shipping labels.
       #
       # @note This operation can make a static sandbox call.
-      # @param body [Hash]
+      # @param body [Hash] PurchaseShipmentRequest body
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def purchase_shipment(body, rate_limit: 5.0)
@@ -95,8 +95,8 @@ module Peddler
 
       # Get service rates.
       #
-      # @note This operation can make a static sandbox call.
-      # @param body [Hash]
+      # @note This operation can make a dynamic sandbox call.
+      # @param body [Hash] GetRatesRequest body
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def get_rates(body, rate_limit: 5.0)
@@ -119,7 +119,7 @@ module Peddler
       # Return the tracking information of a shipment.
       #
       # @note This operation can make a static sandbox call.
-      # @param tracking_id [String]
+      # @param tracking_id [String] Tracking Id
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def get_tracking_information(tracking_id, rate_limit: 1.0)