peddler 2.4.5 → 3.0.0.beta1

data/lib/peddler/api/orders_v0.rb

@@ -0,0 +1,264 @@
+# frozen_string_literal: true
+
+require "peddler/api"
+
+module Peddler
+  class API
+    # 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
+    # demand-based decision support tools. _Note:_ For the JP, AU, and SG marketplaces, the Orders API supports orders
+    # from 2016 onward. For all other marketplaces, the Orders API supports orders for the last two years (orders older
+    # than this don't show up in the response).
+    class OrdersV0 < API
+      # Returns orders that are created or updated during the specified time period. If you want to return specific
+      # types of orders, you can apply filters to your request. `NextToken` doesn't affect any filters that you include
+      # in your request; it only impacts the pagination for the filtered orders response.
+      #
+      # @param [String] created_after Use this date to select orders created after (or at) a specified time. Only orders
+      #   placed after the specified time are returned. The date must be in [ISO
+      #   8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) format. **Note**: Either the `CreatedAfter`
+      #   parameter or the `LastUpdatedAfter` parameter is required. Both cannot be empty. `LastUpdatedAfter` and
+      #   `LastUpdatedBefore` cannot be set when `CreatedAfter` is set.
+      # @param [String] created_before Use this date to select orders created before (or at) a specified time. Only
+      #   orders placed before the specified time are returned. The date must be in [ISO
+      #   8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) format. **Note**: `CreatedBefore` is optional
+      #   when `CreatedAfter` is set. If specified, `CreatedBefore` must be equal to or after the `CreatedAfter` date
+      #   and at least two minutes before current time.
+      # @param [String] last_updated_after Use this date to select orders that were last updated after (or at) a
+      #   specified time. An update is defined as any change in order status, including the creation of a new order.
+      #   Includes updates made by Amazon and by the seller. The date must be in [ISO
+      #   8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) format. **Note**: Either the `CreatedAfter`
+      #   parameter or the `LastUpdatedAfter` parameter is required. Both cannot be empty. `CreatedAfter` or
+      #   `CreatedBefore` cannot be set when `LastUpdatedAfter` is set.
+      # @param [String] last_updated_before Use this date to select orders that were last updated before (or at) a
+      #   specified time. An update is defined as any change in order status, including the creation of a new order.
+      #   Includes updates made by Amazon and by the seller. The date must be in [ISO
+      #   8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) format. **Note**: `LastUpdatedBefore` is
+      #   optional when `LastUpdatedAfter` is set. But if specified, `LastUpdatedBefore` must be equal to or after the
+      #   `LastUpdatedAfter` date and at least two minutes before current time.
+      # @param [Array<String>] order_statuses A list of `OrderStatus` values used to filter the results. **Possible
+      #   values:** - `PendingAvailability` (This status is available for pre-orders only. The order has been placed,
+      #   payment has not been authorized, and the release date of the item is in the future.) - `Pending` (The order
+      #   has been placed but payment has not been authorized.) - `Unshipped` (Payment has been authorized and the order
+      #   is ready for shipment, but no items in the order have been shipped.) - `PartiallyShipped` (One or more, but
+      #   not all, items in the order have been shipped.) - `Shipped` (All items in the order have been shipped.) -
+      #   `InvoiceUnconfirmed` (All items in the order have been shipped. The seller has not yet given confirmation to
+      #   Amazon that the invoice has been shipped to the buyer.) - `Canceled` (The order has been canceled.) -
+      #   `Unfulfillable` (The order cannot be fulfilled. This state applies only to Multi-Channel Fulfillment orders.)
+      # @param [Array<String>] marketplace_ids A list of `MarketplaceId` values. Used to select orders that were placed
+      #   in the specified marketplaces. Refer to [Marketplace
+      #   IDs](https://developer-docs.amazon.com/sp-api/docs/marketplace-ids) for a complete list of `marketplaceId`
+      #   values.
+      # @param [Array<String>] fulfillment_channels A list that indicates how an order was fulfilled. Filters the
+      #   results by fulfillment channel. **Possible values**: `AFN` (fulfilled by Amazon), `MFN` (fulfilled by seller).
+      # @param [Array<String>] payment_methods A list of payment method values. Use this field to select orders that
+      #   were paid with the specified payment methods. **Possible values**: `COD` (cash on delivery), `CVS`
+      #   (convenience store), `Other` (Any payment method other than COD or CVS).
+      # @param [String] buyer_email The email address of a buyer. Used to select orders that contain the specified email
+      #   address.
+      # @param [String] seller_order_id An order identifier that is specified by the seller. Used to select only the
+      #   orders that match the order identifier. If `SellerOrderId` is specified, then `FulfillmentChannels`,
+      #   `OrderStatuses`, `PaymentMethod`, `LastUpdatedAfter`, LastUpdatedBefore, and `BuyerEmail` cannot be specified.
+      # @param [Integer] max_results_per_page A number that indicates the maximum number of orders that can be returned
+      #   per page. Value must be 1 - 100. Default 100.
+      # @param [Array<String>] easy_ship_shipment_statuses A list of `EasyShipShipmentStatus` values. Used to select
+      #   Easy Ship orders with statuses that match the specified values. If `EasyShipShipmentStatus` is specified, only
+      #   Amazon Easy Ship orders are returned. **Possible values:** - `PendingSchedule` (The package is awaiting the
+      #   schedule for pick-up.) - `PendingPickUp` (Amazon has not yet picked up the package from the seller.) -
+      #   `PendingDropOff` (The seller will deliver the package to the carrier.) - `LabelCanceled` (The seller canceled
+      #   the pickup.) - `PickedUp` (Amazon has picked up the package from the seller.) - `DroppedOff` (The package is
+      #   delivered to the carrier by the seller.) - `AtOriginFC` (The packaged is at the origin fulfillment center.) -
+      #   `AtDestinationFC` (The package is at the destination fulfillment center.) - `Delivered` (The package has been
+      #   delivered.) - `RejectedByBuyer` (The package has been rejected by the buyer.) - `Undeliverable` (The package
+      #   cannot be delivered.) - `ReturningToSeller` (The package was not delivered and is being returned to the
+      #   seller.) - `ReturnedToSeller` (The package was not delivered and was returned to the seller.) - `Lost` (The
+      #   package is lost.) - `OutForDelivery` (The package is out for delivery.) - `Damaged` (The package was damaged
+      #   by the carrier.)
+      # @param [Array<String>] electronic_invoice_statuses A list of `ElectronicInvoiceStatus` values. Used to select
+      #   orders with electronic invoice statuses that match the specified values. **Possible values:** - `NotRequired`
+      #   (Electronic invoice submission is not required for this order.) - `NotFound` (The electronic invoice was not
+      #   submitted for this order.) - `Processing` (The electronic invoice is being processed for this order.) -
+      #   `Errored` (The last submitted electronic invoice was rejected for this order.) - `Accepted` (The last
+      #   submitted electronic invoice was submitted and accepted.)
+      # @param [String] next_token A string token returned in the response of your previous request.
+      # @param [Array<String>] amazon_order_ids A list of `AmazonOrderId` values. An `AmazonOrderId` is an
+      #   Amazon-defined order identifier, in 3-7-7 format.
+      # @param [String] actual_fulfillment_supply_source_id The `sourceId` of the location from where you want the order
+      #   fulfilled.
+      # @param [Boolean] is_ispu When true, this order is marked to be picked up from a store rather than delivered.
+      # @param [String] store_chain_store_id The store chain store identifier. Linked to a specific store in a store
+      #   chain.
+      # @param [String] earliest_delivery_date_before Use this date to select orders with a earliest delivery date
+      #   before (or at) a specified time. The date must be in [ISO
+      #   8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) format.
+      # @param [String] earliest_delivery_date_after Use this date to select orders with a earliest delivery date after
+      #   (or at) a specified time. The date must be in [ISO
+      #   8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) format.
+      # @param [String] latest_delivery_date_before Use this date to select orders with a latest delivery date before
+      #   (or at) a specified time. The date must be in [ISO
+      #   8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) format.
+      # @param [String] latest_delivery_date_after Use this date to select orders with a latest delivery date after (or
+      #   at) a specified time. The date must be in [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601)
+      #   format.
+      # @return [Hash] The API response
+      def get_orders(
+        marketplace_ids, created_after: nil, created_before: nil, last_updated_after: nil, last_updated_before: nil,
+        order_statuses: nil, fulfillment_channels: nil, payment_methods: nil, buyer_email: nil, seller_order_id: nil,
+        max_results_per_page: nil, easy_ship_shipment_statuses: nil, electronic_invoice_statuses: nil, next_token: nil,
+        amazon_order_ids: nil, actual_fulfillment_supply_source_id: nil, is_ispu: nil, store_chain_store_id: nil,
+        earliest_delivery_date_before: nil, earliest_delivery_date_after: nil, latest_delivery_date_before: nil,
+        latest_delivery_date_after: nil
+      )
+        path = "/orders/v0/orders"
+        params = {
+          "CreatedAfter" => created_after,
+          "CreatedBefore" => created_before,
+          "LastUpdatedAfter" => last_updated_after,
+          "LastUpdatedBefore" => last_updated_before,
+          "OrderStatuses" => order_statuses,
+          "MarketplaceIds" => marketplace_ids,
+          "FulfillmentChannels" => fulfillment_channels,
+          "PaymentMethods" => payment_methods,
+          "BuyerEmail" => buyer_email,
+          "SellerOrderId" => seller_order_id,
+          "MaxResultsPerPage" => max_results_per_page,
+          "EasyShipShipmentStatuses" => easy_ship_shipment_statuses,
+          "ElectronicInvoiceStatuses" => electronic_invoice_statuses,
+          "NextToken" => next_token,
+          "AmazonOrderIds" => amazon_order_ids,
+          "ActualFulfillmentSupplySourceId" => actual_fulfillment_supply_source_id,
+          "IsISPU" => is_ispu,
+          "StoreChainStoreId" => store_chain_store_id,
+          "EarliestDeliveryDateBefore" => earliest_delivery_date_before,
+          "EarliestDeliveryDateAfter" => earliest_delivery_date_after,
+          "LatestDeliveryDateBefore" => latest_delivery_date_before,
+          "LatestDeliveryDateAfter" => latest_delivery_date_after,
+        }.compact
+
+        rate_limit(0.0167).get(path, params:)
+      end
+
+      # Returns the order that you specify.
+      #
+      # @param [String] order_id An Amazon-defined order identifier, in 3-7-7 format.
+      # @return [Hash] The API response
+      def get_order(order_id)
+        path = "/orders/v0/orders/#{order_id}"
+
+        rate_limit(0.5).get(path)
+      end
+
+      # Returns buyer information for the order that you specify.
+      #
+      # @param [String] order_id An `orderId` is an Amazon-defined order identifier, in 3-7-7 format.
+      # @return [Hash] The API response
+      def get_order_buyer_info(order_id)
+        path = "/orders/v0/orders/#{order_id}/buyerInfo"
+
+        rate_limit(0.5).get(path)
+      end
+
+      # Returns the shipping address for the order that you specify.
+      #
+      # @param [String] order_id An `orderId` is an Amazon-defined order identifier, in 3-7-7 format.
+      # @return [Hash] The API response
+      def get_order_address(order_id)
+        path = "/orders/v0/orders/#{order_id}/address"
+
+        rate_limit(0.5).get(path)
+      end
+
+      # Returns the fulfillment instructions for the order that you specify.
+      #
+      # @param [String] order_id An Amazon-defined order identifier, in 3-7-7 format.
+      # @return [Hash] The API response
+      def get_order_fulfillment_instructions(order_id)
+        path = "/orders/v0/orders/#{order_id}/fulfillmentInstructions"
+
+        rate_limit(0.5).get(path)
+      end
+
+      # Returns detailed order item information for the order that you specify. If `NextToken` is provided, it's used to
+      # retrieve the next page of order items. __Note__: When an order is in the Pending state (the order has been
+      # placed but payment has not been authorized), the getOrderItems operation does not return information about
+      # pricing, taxes, shipping charges, gift status or promotions for the order items in the order. After an order
+      # leaves the Pending state (this occurs when payment has been authorized) and enters the Unshipped, Partially
+      # Shipped, or Shipped state, the getOrderItems operation returns information about pricing, taxes, shipping
+      # charges, gift status and promotions for the order items in the order.
+      #
+      # @param [String] order_id An Amazon-defined order identifier, in 3-7-7 format.
+      # @param [String] next_token A string token returned in the response of your previous request.
+      # @return [Hash] The API response
+      def get_order_items(order_id, next_token: nil)
+        path = "/orders/v0/orders/#{order_id}/orderItems"
+        params = {
+          "NextToken" => next_token,
+        }.compact
+
+        rate_limit(0.5).get(path, params:)
+      end
+
+      # Returns buyer information for the order items in the order that you specify.
+      #
+      # @param [String] order_id An Amazon-defined order identifier, in 3-7-7 format.
+      # @param [String] next_token A string token returned in the response of your previous request.
+      # @return [Hash] The API response
+      def get_order_items_buyer_info(order_id, next_token: nil)
+        path = "/orders/v0/orders/#{order_id}/orderItems/buyerInfo"
+        params = {
+          "NextToken" => next_token,
+        }.compact
+
+        rate_limit(0.5).get(path, params:)
+      end
+
+      # Update the shipment status for an order that you specify.
+      #
+      # @param [String] order_id An Amazon-defined order identifier, in 3-7-7 format.
+      # @param [Hash] payload The request body for the `updateShipmentStatus` operation.
+      # @return [Hash] The API response
+      def update_shipment_status(order_id, payload)
+        path = "/orders/v0/orders/#{order_id}/shipment"
+        body = payload
+
+        rate_limit(5.0).post(path, body:)
+      end
+
+      # Returns regulated information for the order that you specify.
+      #
+      # @param [String] order_id An Amazon-defined order identifier, in 3-7-7 format.
+      # @return [Hash] The API response
+      def get_order_regulated_info(order_id)
+        path = "/orders/v0/orders/#{order_id}/regulatedInfo"
+
+        rate_limit(0.5).get(path)
+      end
+
+      # Updates (approves or rejects) the verification status of an order containing regulated products.
+      #
+      # @param [String] order_id An Amazon-defined order identifier, in 3-7-7 format.
+      # @param [Hash] payload The request body for the `updateVerificationStatus` operation.
+      # @return [Hash] The API response
+      def update_verification_status(order_id, payload)
+        path = "/orders/v0/orders/#{order_id}/regulatedInfo"
+        body = payload
+
+        rate_limit(0.5).patch(path, body:)
+      end
+
+      # Updates the shipment confirmation status for a specified order.
+      #
+      # @param [String] order_id An Amazon-defined order identifier, in 3-7-7 format.
+      # @param [Hash] payload Request body of `confirmShipment`.
+      # @return [Hash] The API response
+      def confirm_shipment(order_id, payload)
+        path = "/orders/v0/orders/#{order_id}/shipmentConfirmation"
+        body = payload
+
+        rate_limit(2.0).post(path, body:)
+      end
+    end
+  end
+end

data/lib/peddler/api/product_fees_v0.rb

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+
+require "peddler/api"
+
+module Peddler
+  class API
+    # Selling Partner API for Product Fees
+    #
+    # The Selling Partner API for Product Fees lets you programmatically retrieve estimated fees for a product. You can
+    # then account for those fees in your pricing.
+    class ProductFeesV0 < API
+      # Returns the estimated fees for the item indicated by the specified seller SKU in the marketplace specified in
+      # the request body.
+      # @note The parameters associated with this operation may contain special characters that require URL encoding to
+      #   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). You can call `getMyFeesEstimateForSKU`
+      #   for an item on behalf of a selling partner before the selling partner sets the item's price. The selling
+      #   partner can then take any estimated fees into account. Each fees estimate request must include an original
+      #   identifier. This identifier is included in the fees estimate so that you can correlate a fees estimate with
+      #   the original request.
+      # @note This identifier value is used to identify an estimate. Actual costs may vary. Search "fees" in [Seller
+      #   Central](https://sellercentral.amazon.com/) and consult the store-specific fee schedule for the most
+      #   up-to-date information.
+      # @note When sellers use the `getMyFeesEstimateForSKU` operation with their `SellerSKU`, they get accurate fees
+      #   based on real item measurements, but only after they've sent their items to Amazon.
+      #
+      # @param [Hash] body
+      # @param [String] seller_sku Used to identify an item in the given marketplace. SellerSKU is qualified by the
+      #   seller's SellerId, which is included with every operation that you submit.
+      # @return [Hash] The API response
+      def get_my_fees_estimate_for_sku(body, seller_sku)
+        path = "/products/fees/v0/listings/#{seller_sku}/feesEstimate"
+
+        rate_limit(1.0).post(path, body:)
+      end
+
+      # Returns the estimated fees for the item indicated by the specified ASIN in the marketplace specified in the
+      # request body. You can call `getMyFeesEstimateForASIN` for an item on behalf of a selling partner before the
+      # selling partner sets the item's price. The selling partner can then take estimated fees into account. Each fees
+      # request must include an original identifier. This identifier is included in the fees estimate so you can
+      # correlate a fees estimate with the original request.
+      # @note This identifier value is used to identify an estimate. Actual costs may vary. Search "fees" in [Seller
+      #   Central](https://sellercentral.amazon.com/) and consult the store-specific fee schedule for the most
+      #   up-to-date information.
+      # @note When using the `getMyFeesEstimateForASIN` operation with an ASIN, the fee estimates might be different.
+      #   This is because these estimates use the item's catalog size, which might not always match the actual size of
+      #   the item sent to Amazon.
+      #
+      # @param [Hash] body
+      # @param [String] asin The Amazon Standard Identification Number (ASIN) of the item.
+      # @return [Hash] The API response
+      def get_my_fees_estimate_for_asin(body, asin)
+        path = "/products/fees/v0/items/#{asin}/feesEstimate"
+
+        rate_limit(1.0).post(path, body:)
+      end
+
+      # Returns the estimated fees for a list of products.
+      #
+      # @param [Hash] body
+      # @return [Hash] The API response
+      def get_my_fees_estimates(body)
+        path = "/products/fees/v0/feesEstimate"
+
+        rate_limit(0.5).post(path, body:)
+      end
+    end
+  end
+end

data/lib/peddler/api/product_pricing_2022_05_01.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+require "peddler/api"
+
+module Peddler
+  class API
+    # Selling Partner API for Pricing
+    #
+    # The Selling Partner API for Pricing helps you programmatically retrieve product pricing and offer pricing
+    # information for Amazon Marketplace products. For more information, refer to the [Product Pricing v2022-05-01 Use
+    # Case Guide](https://developer-docs.amazon.com/sp-api/docs/product-pricing-api-v2022-05-01-use-case-guide).
+    class ProductPricing20220501 < API
+      # Returns the set of responses that correspond to the batched list of up to 40 requests defined in the request
+      # body. The response for each successful (HTTP status code 200) request in the set includes the computed listing
+      # price at or below which a seller can expect to become the featured offer (before applicable promotions). This is
+      # called the featured offer expected price (FOEP). Featured offer is not guaranteed, because competing offers may
+      # change, and different offers may be featured based on other factors, including fulfillment capabilities to a
+      # specific customer. The response to an unsuccessful request includes the available error text.
+      #
+      # @param [Hash] get_featured_offer_expected_price_batch_request_body The batch of `getFeaturedOfferExpectedPrice`
+      #   requests.
+      # @return [Hash] The API response
+      def get_featured_offer_expected_price_batch(get_featured_offer_expected_price_batch_request_body)
+        path = "/batches/products/pricing/2022-05-01/offer/featuredOfferExpectedPrice"
+        body = get_featured_offer_expected_price_batch_request_body
+
+        rate_limit(0.033).post(path, body:)
+      end
+
+      # Returns the competitive summary response including featured buying options for the ASIN and `marketplaceId`
+      # combination.
+      #
+      # @param [Hash] requests The batch of `getCompetitiveSummary` requests.
+      # @return [Hash] The API response
+      def get_competitive_summary(requests)
+        path = "/batches/products/pricing/2022-05-01/items/competitiveSummary"
+        body = requests
+
+        rate_limit(0.033).post(path, body:)
+      end
+    end
+  end
+end

data/lib/peddler/api/product_pricing_v0.rb

@@ -0,0 +1,144 @@
+# frozen_string_literal: true
+
+require "peddler/api"
+
+module Peddler
+  class API
+    # Selling Partner API for Pricing
+    #
+    # The Selling Partner API for Pricing helps you programmatically retrieve product pricing and offer information for
+    # Amazon Marketplace products.
+    class ProductPricingV0 < API
+      # Returns pricing information for a seller's offer listings based on seller SKU or ASIN.
+      # @note The parameters associated with this operation may contain special characters that require URL encoding to
+      #   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).
+      #
+      # @param [String] marketplace_id A marketplace identifier. Specifies the marketplace for which prices are
+      #   returned.
+      # @param [Array<String>] asins A list of up to twenty Amazon Standard Identification Number (ASIN) values used to
+      #   identify items in the given marketplace.
+      # @param [Array<String>] skus A list of up to twenty seller SKU values used to identify items in the given
+      #   marketplace.
+      # @param [String] item_type Indicates whether ASIN values or seller SKU values are used to identify items. If you
+      #   specify Asin, the information in the response will be dependent on the list of Asins you provide in the Asins
+      #   parameter. If you specify Sku, the information in the response will be dependent on the list of Skus you
+      #   provide in the Skus parameter.
+      # @param [String] item_condition Filters the offer listings based on item condition. Possible values: New, Used,
+      #   Collectible, Refurbished, Club.
+      # @param [String] offer_type Indicates whether to request pricing information for the seller's B2C or B2B offers.
+      #   Default is B2C.
+      # @return [Hash] The API response
+      def get_pricing(marketplace_id, item_type, asins: nil, skus: nil, item_condition: nil, offer_type: nil)
+        path = "/products/pricing/v0/price"
+        params = {
+          "MarketplaceId" => marketplace_id,
+          "Asins" => asins,
+          "Skus" => skus,
+          "ItemType" => item_type,
+          "ItemCondition" => item_condition,
+          "OfferType" => offer_type,
+        }.compact
+
+        rate_limit(0.5).get(path, params:)
+      end
+
+      # Returns competitive pricing information for a seller's offer listings based on seller SKU or ASIN.
+      # @note The parameters associated with this operation may contain special characters that require URL encoding to
+      #   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).
+      #
+      # @param [String] marketplace_id A marketplace identifier. Specifies the marketplace for which prices are
+      #   returned.
+      # @param [Array<String>] asins A list of up to twenty Amazon Standard Identification Number (ASIN) values used to
+      #   identify items in the given marketplace.
+      # @param [Array<String>] skus A list of up to twenty seller SKU values used to identify items in the given
+      #   marketplace.
+      # @param [String] item_type Indicates whether ASIN values or seller SKU values are used to identify items. If you
+      #   specify Asin, the information in the response will be dependent on the list of Asins you provide in the Asins
+      #   parameter. If you specify Sku, the information in the response will be dependent on the list of Skus you
+      #   provide in the Skus parameter. Possible values: Asin, Sku.
+      # @param [String] customer_type Indicates whether to request pricing information from the point of view of
+      #   Consumer or Business buyers. Default is Consumer.
+      # @return [Hash] The API response
+      def get_competitive_pricing(marketplace_id, item_type, asins: nil, skus: nil, customer_type: nil)
+        path = "/products/pricing/v0/competitivePrice"
+        params = {
+          "MarketplaceId" => marketplace_id,
+          "Asins" => asins,
+          "Skus" => skus,
+          "ItemType" => item_type,
+          "CustomerType" => customer_type,
+        }.compact
+
+        rate_limit(0.5).get(path, params:)
+      end
+
+      # Returns the lowest priced offers for a single SKU listing.
+      # @note The parameters associated with this operation may contain special characters that require URL encoding to
+      #   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).
+      #
+      # @param [String] marketplace_id A marketplace identifier. Specifies the marketplace for which prices are
+      #   returned.
+      # @param [String] item_condition Filters the offer listings based on item condition. Possible values: New, Used,
+      #   Collectible, Refurbished, Club.
+      # @param [String] seller_sku Identifies an item in the given marketplace. SellerSKU is qualified by the seller's
+      #   SellerId, which is included with every operation that you submit.
+      # @param [String] customer_type Indicates whether to request Consumer or Business offers. Default is Consumer.
+      # @return [Hash] The API response
+      def get_listing_offers(marketplace_id, item_condition, seller_sku, customer_type: nil)
+        path = "/products/pricing/v0/listings/#{seller_sku}/offers"
+        params = {
+          "MarketplaceId" => marketplace_id,
+          "ItemCondition" => item_condition,
+          "CustomerType" => customer_type,
+        }.compact
+
+        rate_limit(1.0).get(path, params:)
+      end
+
+      # Returns the lowest priced offers for a single item based on ASIN.
+      #
+      # @param [String] marketplace_id A marketplace identifier. Specifies the marketplace for which prices are
+      #   returned.
+      # @param [String] item_condition Filters the offer listings to be considered based on item condition. Possible
+      #   values: New, Used, Collectible, Refurbished, Club.
+      # @param [String] asin The Amazon Standard Identification Number (ASIN) of the item.
+      # @param [String] customer_type Indicates whether to request Consumer or Business offers. Default is Consumer.
+      # @return [Hash] The API response
+      def get_item_offers(marketplace_id, item_condition, asin, customer_type: nil)
+        path = "/products/pricing/v0/items/#{asin}/offers"
+        params = {
+          "MarketplaceId" => marketplace_id,
+          "ItemCondition" => item_condition,
+          "CustomerType" => customer_type,
+        }.compact
+
+        rate_limit(0.5).get(path, params:)
+      end
+
+      # Returns the lowest priced offers for a batch of items based on ASIN.
+      #
+      # @param [Hash] get_item_offers_batch_request_body
+      # @return [Hash] The API response
+      def get_item_offers_batch(get_item_offers_batch_request_body)
+        path = "/batches/products/pricing/v0/itemOffers"
+        body = get_item_offers_batch_request_body
+
+        rate_limit(0.1).post(path, body:)
+      end
+
+      # Returns the lowest priced offers for a batch of listings by SKU.
+      #
+      # @param [Hash] get_listing_offers_batch_request_body
+      # @return [Hash] The API response
+      def get_listing_offers_batch(get_listing_offers_batch_request_body)
+        path = "/batches/products/pricing/v0/listingOffers"
+        body = get_listing_offers_batch_request_body
+
+        rate_limit(0.5).post(path, body:)
+      end
+    end
+  end
+end

data/lib/peddler/api/product_type_definitions_2020_09_01.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+require "peddler/api"
+
+module Peddler
+  class API
+    # Selling Partner API for Product Type Definitions
+    #
+    # The Selling Partner API for Product Type Definitions provides programmatic access to attribute and data
+    # requirements for product types in the Amazon catalog. Use this API to return the JSON Schema for a product type
+    # that you can then use with other Selling Partner APIs, such as the Selling Partner API for Listings Items, the
+    # Selling Partner API for Catalog Items, and the Selling Partner API for Feeds (for JSON-based listing feeds). For
+    # more information, see the [Product Type Definitions API Use Case Guide](doc:product-type-api-use-case-guide).
+    class ProductTypeDefinitions20200901 < API
+      # Search for and return a list of Amazon product types that have definitions available.
+      #
+      # @param [Array<String>] keywords A comma-delimited list of keywords to search product types. **Note:** Cannot be
+      #   used with `itemName`.
+      # @param [Array<String>] marketplace_ids A comma-delimited list of Amazon marketplace identifiers for the request.
+      # @param [String] item_name The title of the ASIN to get the product type recommendation. **Note:** Cannot be used
+      #   with `keywords`.
+      # @param [String] locale The locale for the display names in the response. Defaults to the primary locale of the
+      #   marketplace.
+      # @param [String] search_locale The locale used for the `keywords` and `itemName` parameters. Defaults to the
+      #   primary locale of the marketplace.
+      # @return [Hash] The API response
+      def search_definitions_product_types(marketplace_ids, keywords: nil, item_name: nil, locale: nil,
+        search_locale: nil)
+        path = "/definitions/2020-09-01/productTypes"
+        params = {
+          "keywords" => keywords,
+          "marketplaceIds" => marketplace_ids,
+          "itemName" => item_name,
+          "locale" => locale,
+          "searchLocale" => search_locale,
+        }.compact
+
+        rate_limit(5.0).get(path, params:)
+      end
+
+      # Retrieve an Amazon product type definition.
+      #
+      # @param [String] product_type The Amazon product type name.
+      # @param [String] seller_id A selling partner identifier. When provided, seller-specific requirements and values
+      #   are populated within the product type definition schema, such as brand names associated with the selling
+      #   partner.
+      # @param [Array<String>] marketplace_ids A comma-delimited list of Amazon marketplace identifiers for the request.
+      #   Note: This parameter is limited to one marketplaceId at this time.
+      # @param [String] product_type_version The version of the Amazon product type to retrieve. Defaults to "LATEST",.
+      #   Prerelease versions of product type definitions may be retrieved with "RELEASE_CANDIDATE". If no prerelease
+      #   version is currently available, the "LATEST" live version will be provided.
+      # @param [String] requirements The name of the requirements set to retrieve requirements for.
+      # @param [String] requirements_enforced Identifies if the required attributes for a requirements set are enforced
+      #   by the product type definition schema. Non-enforced requirements enable structural validation of individual
+      #   attributes without all the required attributes being present (such as for partial updates).
+      # @param [String] locale Locale for retrieving display labels and other presentation details. Defaults to the
+      #   default language of the first marketplace in the request.
+      # @return [Hash] The API response
+      def get_definitions_product_type(product_type, marketplace_ids, seller_id: nil, product_type_version: nil,
+        requirements: nil, requirements_enforced: nil, locale: nil)
+        path = "/definitions/2020-09-01/productTypes/#{product_type}"
+        params = {
+          "sellerId" => seller_id,
+          "marketplaceIds" => marketplace_ids,
+          "productTypeVersion" => product_type_version,
+          "requirements" => requirements,
+          "requirementsEnforced" => requirements_enforced,
+          "locale" => locale,
+        }.compact
+
+        rate_limit(5.0).get(path, params:)
+      end
+    end
+  end
+end

data/lib/peddler/api/replenishment_2022_11_07.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+require "peddler/api"
+
+module Peddler
+  class API
+    # Selling Partner API for Replenishment
+    #
+    # The Selling Partner API for Replenishment (Replenishment API) provides programmatic access to replenishment
+    # program metrics and offers. These programs provide recurring delivery of any replenishable item at a frequency
+    # chosen by the customer. The Replenishment API is available worldwide wherever Amazon Subscribe & Save is available
+    # or is supported. The API is available to vendors and FBA selling partners.
+    class Replenishment20221107 < API
+      # Returns aggregated replenishment program metrics for a selling partner.
+      #
+      # @param [Hash] body The request body for the `getSellingPartnerMetrics` operation.
+      # @return [Hash] The API response
+      def get_selling_partner_metrics(body: nil)
+        path = "/replenishment/2022-11-07/sellingPartners/metrics/search"
+
+        rate_limit(1.0).post(path, body:)
+      end
+
+      # Returns aggregated replenishment program metrics for a selling partner's offers.
+      #
+      # @param [Hash] body The request body for the `listOfferMetrics` operation.
+      # @return [Hash] The API response
+      def list_offer_metrics(body: nil)
+        path = "/replenishment/2022-11-07/offers/metrics/search"
+
+        rate_limit(1.0).post(path, body:)
+      end
+
+      # Returns the details of a selling partner's replenishment program offers.
+      #
+      # @param [Hash] body The request body for the `listOffers` operation.
+      # @return [Hash] The API response
+      def list_offers(body: nil)
+        path = "/replenishment/2022-11-07/offers/search"
+
+        rate_limit(1.0).post(path, body:)
+      end
+    end
+  end
+end