peddler 2.4.5 → 3.0.0

data/lib/peddler/api/invoices_2024_06_19.rb

@@ -0,0 +1,180 @@
+# frozen_string_literal: true
+
+require "peddler/api"
+
+module Peddler
+  class << self
+    def invoices_2024_06_19(...)
+      API::Invoices20240619.new(...)
+    end
+  end
+
+  class API
+    # The Selling Partner API for Invoices.
+    #
+    # Use the Selling Partner API for Invoices to retrieve and manage invoice-related operations, which can help selling
+    # partners manage their bookkeeping processes.
+    class Invoices20240619 < API
+      # Returns marketplace-dependent schemas and their respective set of possible values.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param marketplace_id [String] The marketplace identifier.
+      # @param rate_limit [Float] Requests per second
+      # @return [Hash] The API response
+      def get_invoices_attributes(marketplace_id, rate_limit: 1.0)
+        path = "/tax/invoices/2024-06-19/attributes"
+        params = {
+          "marketplaceId" => marketplace_id,
+        }.compact
+
+        meter(rate_limit).get(path, params:)
+      end
+
+      # Returns the invoice document's ID and URL. Use the URL to download the ZIP file, which contains the invoices
+      # from the corresponding `createInvoicesExport` request.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param invoices_document_id [String] The export document identifier.
+      # @param rate_limit [Float] Requests per second
+      # @return [Hash] The API response
+      def get_invoices_document(invoices_document_id, rate_limit: 0.0167)
+        path = "/tax/invoices/2024-06-19/documents/#{invoices_document_id}"
+
+        meter(rate_limit).get(path)
+      end
+
+      # Creates an invoice export request.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param body [Hash] Information required to create the export request.
+      # @param rate_limit [Float] Requests per second
+      # @return [Hash] The API response
+      def create_invoices_export(body, rate_limit: 0.167)
+        path = "/tax/invoices/2024-06-19/exports"
+
+        meter(rate_limit).post(path, body:)
+      end
+
+      # Returns invoice exports details for exports that match the filters that you specify.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param marketplace_id [String] The returned exports match the specified marketplace.
+      # @param date_start [String] The earliest export creation date and time for exports that you want to include in
+      #   the response. Values are in [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) date-time
+      #   format. The default is 30 days ago.
+      # @param next_token [String] The response includes `nextToken` 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 `nextToken`
+      #   is null. Note that this operation can return empty pages.
+      # @param page_size [Integer] The maximum number of invoices to return in a single call. Minimum: 1 Maximum: 100
+      # @param date_end [String] The latest export creation date and time for exports that you want to include in the
+      #   response. Values are in [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) date-time format.
+      #   The default value is the time of the request.
+      # @param status [String] Return exports matching the status specified.
+      # @param rate_limit [Float] Requests per second
+      # @return [Hash] The API response
+      def get_invoices_exports(marketplace_id, date_start: nil, next_token: nil, page_size: nil, date_end: nil,
+        status: nil, rate_limit: 0.1)
+        path = "/tax/invoices/2024-06-19/exports"
+        params = {
+          "marketplaceId" => marketplace_id,
+          "dateStart" => date_start,
+          "nextToken" => next_token,
+          "pageSize" => page_size,
+          "dateEnd" => date_end,
+          "status" => status,
+        }.compact
+
+        meter(rate_limit).get(path, params:)
+      end
+
+      # Returns invoice export details (including the `exportDocumentId`, if available) for the export that you specify.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param export_id [String] The unique identifier for the export.
+      # @param rate_limit [Float] Requests per second
+      # @return [Hash] The API response
+      def get_invoices_export(export_id, rate_limit: 2.0)
+        path = "/tax/invoices/2024-06-19/exports/#{export_id}"
+
+        meter(rate_limit).get(path)
+      end
+
+      # Returns invoice details for the invoices that match the filters that you specify.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param transaction_identifier_name [String] The name of the transaction identifier filter. If you provide a
+      #   value for this field, you must also provide a value for the `transactionIdentifierId` field.Use the
+      #   `getInvoicesAttributes` operation to check `transactionIdentifierName` options.
+      # @param page_size [Integer] The maximum number of invoices you want to return in a single call. Minimum: 1
+      #   Maximum: 200
+      # @param date_end [String] The latest invoice creation date for invoices that you want to include in the response.
+      #   Dates are in [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) date-time format. The default
+      #   is the current date-time.
+      # @param marketplace_id [String] The response includes only the invoices that match the specified marketplace.
+      # @param transaction_type [String] The marketplace-specific classification of the transaction type for which the
+      #   invoice was created. Use the `getInvoicesAttributes` operation to check `transactionType` options.
+      # @param transaction_identifier_id [String] The ID of the transaction identifier filter. If you provide a value
+      #   for this field, you must also provide a value for the `transactionIdentifierName` field.
+      # @param date_start [String] The earliest invoice creation date for invoices that you want to include in the
+      #   response. Dates are in [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) date-time format.
+      #   The default is 24 hours prior to the time of the request.
+      # @param series [String] Return invoices with the specified series number.
+      # @param next_token [String] The response includes `nextToken` 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 `nextToken`
+      #   is null. Note that this operation can return empty pages.
+      # @param sort_order [String] Sort the invoices in the response in ascending or descending order.
+      # @param invoice_type [String] The marketplace-specific classification of the invoice type. Use the
+      #   `getInvoicesAttributes` operation to check `invoiceType` options.
+      # @param statuses [Array<String>] A list of statuses that you can use to filter invoices. Use the
+      #   `getInvoicesAttributes` operation to check invoice status options. Min count: 1
+      # @param external_invoice_id [String] Return invoices that match this external ID. This is typically the
+      #   Government Invoice ID.
+      # @param sort_by [String] The attribute by which you want to sort the invoices in the response.
+      # @param rate_limit [Float] Requests per second
+      # @return [Hash] The API response
+      def get_invoices(marketplace_id, transaction_identifier_name: nil, page_size: nil, date_end: nil,
+        transaction_type: nil, transaction_identifier_id: nil, date_start: nil, series: nil, next_token: nil,
+        sort_order: nil, invoice_type: nil, statuses: nil, external_invoice_id: nil, sort_by: nil, rate_limit: 0.1)
+        path = "/tax/invoices/2024-06-19/invoices"
+        params = {
+          "transactionIdentifierName" => transaction_identifier_name,
+          "pageSize" => page_size,
+          "dateEnd" => date_end,
+          "marketplaceId" => marketplace_id,
+          "transactionType" => transaction_type,
+          "transactionIdentifierId" => transaction_identifier_id,
+          "dateStart" => date_start,
+          "series" => series,
+          "nextToken" => next_token,
+          "sortOrder" => sort_order,
+          "invoiceType" => invoice_type,
+          "statuses" => statuses,
+          "externalInvoiceId" => external_invoice_id,
+          "sortBy" => sort_by,
+        }.compact
+
+        meter(rate_limit).get(path, params:)
+      end
+
+      # Returns invoice data for the specified invoice. This operation returns only a subset of the invoices data; refer
+      # to the response definition to get all the possible attributes. To get the full invoice, use the
+      # `createInvoicesExport` operation to start an export request.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param marketplace_id [String] The marketplace from which you want the invoice.
+      # @param invoice_id [String] The invoice identifier.
+      # @param rate_limit [Float] Requests per second
+      # @return [Hash] The API response
+      def get_invoice(marketplace_id, invoice_id, rate_limit: 2.0)
+        path = "/tax/invoices/2024-06-19/invoices/#{invoice_id}"
+        params = {
+          "marketplaceId" => marketplace_id,
+        }.compact
+
+        meter(rate_limit).get(path, params:)
+      end
+    end
+  end
+end

data/lib/peddler/api/listings_items_2020_09_01.rb

@@ -0,0 +1,95 @@
+# frozen_string_literal: true
+
+require "peddler/api"
+
+module Peddler
+  class << self
+    def listings_items_2020_09_01(...)
+      API::ListingsItems20200901.new(...)
+    end
+  end
+
+  class API
+    # Selling Partner API for Listings Items
+    #
+    # The Selling Partner API for Listings Items (Listings Items API) provides programmatic access to selling partner
+    # listings on Amazon. Use this API in collaboration with the Selling Partner API for Product Type Definitions, which
+    # you use to retrieve the information about Amazon product types needed to use the Listings Items API. For more
+    # information, see the {https://developer-docs.amazon.com/sp-api/docs/listings-items-api-v2020-09-01-use-case-guide
+    # Listing Items API Use Case Guide}.
+    class ListingsItems20200901 < API
+      # Delete a listings item for a selling partner. **Note:** The parameters associated with this operation may
+      # contain special characters that must be encoded to successfully call the API. To avoid errors with SKUs when
+      # encoding URLs, refer to [URL Encoding](https://developer-docs.amazon.com/sp-api/docs/url-encoding).
+      #
+      # @note This operation can make a static sandbox call.
+      # @param seller_id [String] A selling partner identifier, such as a merchant account or vendor code.
+      # @param sku [String] A selling partner provided identifier for an Amazon listing.
+      # @param marketplace_ids [Array<String>] A comma-delimited list of Amazon marketplace identifiers for the request.
+      # @param issue_locale [String] A locale for localization of issues. When not provided, the default language code
+      #   of the first marketplace is used. Examples: "en_US", "fr_CA", "fr_FR". Localized messages default to "en_US"
+      #   when a localization is not available in the specified locale.
+      # @param rate_limit [Float] Requests per second
+      # @return [Hash] The API response
+      def delete_listings_item(seller_id, sku, marketplace_ids, issue_locale: nil, rate_limit: 5.0)
+        path = "/listings/2020-09-01/items/#{seller_id}/#{sku}"
+        params = {
+          "marketplaceIds" => marketplace_ids,
+          "issueLocale" => issue_locale,
+        }.compact
+
+        meter(rate_limit).delete(path, params:)
+      end
+
+      # Partially update (patch) a listings item for a selling partner. Only top-level listings item attributes can be
+      # patched. Patching nested attributes is not supported. **Note:** The parameters associated with this operation
+      # may contain special characters that must be encoded to successfully call the API. To avoid errors with SKUs when
+      # encoding URLs, refer to [URL Encoding](https://developer-docs.amazon.com/sp-api/docs/url-encoding).
+      #
+      # @note This operation can make a static sandbox call.
+      # @param seller_id [String] A selling partner identifier, such as a merchant account or vendor code.
+      # @param sku [String] A selling partner provided identifier for an Amazon listing.
+      # @param marketplace_ids [Array<String>] A comma-delimited list of Amazon marketplace identifiers for the request.
+      # @param issue_locale [String] A locale for localization of issues. When not provided, the default language code
+      #   of the first marketplace is used. Examples: "en_US", "fr_CA", "fr_FR". Localized messages default to "en_US"
+      #   when a localization is not available in the specified locale.
+      # @param body [Hash] The request body schema for the patchListingsItem operation.
+      # @param rate_limit [Float] Requests per second
+      # @return [Hash] The API response
+      def patch_listings_item(seller_id, sku, marketplace_ids, body, issue_locale: nil, rate_limit: 5.0)
+        path = "/listings/2020-09-01/items/#{seller_id}/#{sku}"
+        params = {
+          "marketplaceIds" => marketplace_ids,
+          "issueLocale" => issue_locale,
+        }.compact
+
+        meter(rate_limit).patch(path, body:, params:)
+      end
+
+      # Creates a new or fully-updates an existing listings item for a selling partner. **Note:** The parameters
+      # associated with this operation may contain special characters that must be encoded to successfully call the API.
+      # To avoid errors with SKUs when encoding URLs, refer to [URL
+      # Encoding](https://developer-docs.amazon.com/sp-api/docs/url-encoding).
+      #
+      # @note This operation can make a static sandbox call.
+      # @param seller_id [String] A selling partner identifier, such as a merchant account or vendor code.
+      # @param sku [String] A selling partner provided identifier for an Amazon listing.
+      # @param marketplace_ids [Array<String>] A comma-delimited list of Amazon marketplace identifiers for the request.
+      # @param issue_locale [String] A locale for localization of issues. When not provided, the default language code
+      #   of the first marketplace is used. Examples: "en_US", "fr_CA", "fr_FR". Localized messages default to "en_US"
+      #   when a localization is not available in the specified locale.
+      # @param body [Hash] The request body schema for the putListingsItem operation.
+      # @param rate_limit [Float] Requests per second
+      # @return [Hash] The API response
+      def put_listings_item(seller_id, sku, marketplace_ids, body, issue_locale: nil, rate_limit: 5.0)
+        path = "/listings/2020-09-01/items/#{seller_id}/#{sku}"
+        params = {
+          "marketplaceIds" => marketplace_ids,
+          "issueLocale" => issue_locale,
+        }.compact
+
+        meter(rate_limit).put(path, body:, params:)
+      end
+    end
+  end
+end

data/lib/peddler/api/listings_items_2021_08_01.rb

@@ -0,0 +1,170 @@
+# frozen_string_literal: true
+
+require "peddler/api"
+
+module Peddler
+  class << self
+    def listings_items_2021_08_01(...)
+      API::ListingsItems20210801.new(...)
+    end
+  end
+
+  class API
+    # Selling Partner API for Listings Items
+    #
+    # The Selling Partner API for Listings Items (Listings Items API) provides programmatic access to selling partner
+    # listings on Amazon. Use this API in collaboration with the Selling Partner API for Product Type Definitions, which
+    # you use to retrieve the information about Amazon product types needed to use the Listings Items API. For more
+    # information, see the [Listings Items API Use Case
+    # Guide](https://developer-docs.amazon.com/sp-api/docs/listings-items-api-v2021-08-01-use-case-guide).
+    class ListingsItems20210801 < API
+      # Delete a listings item for a selling partner. **Note:** The parameters associated with this operation may
+      # contain special characters that must be encoded to successfully call the API. To avoid errors with SKUs when
+      # encoding URLs, refer to [URL Encoding](https://developer-docs.amazon.com/sp-api/docs/url-encoding).
+      #
+      # @note This operation can make a static sandbox call.
+      # @param seller_id [String] A selling partner identifier, such as a merchant account or vendor code.
+      # @param sku [String] A selling partner provided identifier for an Amazon listing.
+      # @param marketplace_ids [Array<String>] A comma-delimited list of Amazon marketplace identifiers for the request.
+      # @param issue_locale [String] A locale for localization of issues. When not provided, the default language code
+      #   of the first marketplace is used. Examples: `en_US`, `fr_CA`, `fr_FR`. Localized messages default to `en_US`
+      #   when a localization is not available in the specified locale.
+      # @param rate_limit [Float] Requests per second
+      # @return [Hash] The API response
+      def delete_listings_item(seller_id, sku, marketplace_ids, issue_locale: nil, rate_limit: 5.0)
+        path = "/listings/2021-08-01/items/#{seller_id}/#{sku}"
+        params = {
+          "marketplaceIds" => marketplace_ids,
+          "issueLocale" => issue_locale,
+        }.compact
+
+        meter(rate_limit).delete(path, params:)
+      end
+
+      # Returns details about a listings item for a selling partner. **Note:** The parameters associated with this
+      # operation may contain special characters that must be encoded to successfully call the API. To avoid errors with
+      # SKUs when encoding URLs, refer to [URL Encoding](https://developer-docs.amazon.com/sp-api/docs/url-encoding).
+      #
+      # @note This operation can make a static sandbox call.
+      # @param seller_id [String] A selling partner identifier, such as a merchant account or vendor code.
+      # @param sku [String] A selling partner provided identifier for an Amazon listing.
+      # @param marketplace_ids [Array<String>] A comma-delimited list of Amazon marketplace identifiers for the request.
+      # @param issue_locale [String] A locale for localization of issues. When not provided, the default language code
+      #   of the first marketplace is used. Examples: `en_US`, `fr_CA`, `fr_FR`. Localized messages default to `en_US`
+      #   when a localization is not available in the specified locale.
+      # @param included_data [Array<String>] A comma-delimited list of data sets to include in the response. Default:
+      #   `summaries`.
+      # @param rate_limit [Float] Requests per second
+      # @return [Hash] The API response
+      def get_listings_item(seller_id, sku, marketplace_ids, issue_locale: nil, included_data: ["summaries"],
+        rate_limit: 5.0)
+        path = "/listings/2021-08-01/items/#{seller_id}/#{sku}"
+        params = {
+          "marketplaceIds" => marketplace_ids,
+          "issueLocale" => issue_locale,
+          "includedData" => included_data,
+        }.compact
+
+        meter(rate_limit).get(path, params:)
+      end
+
+      # Partially update (patch) a listings item for a selling partner. Only top-level listings item attributes can be
+      # patched. Patching nested attributes is not supported. **Note:** This operation has a throttling rate of one
+      # request per second when `mode` is `VALIDATION_PREVIEW`. **Note:** The parameters associated with this operation
+      # may contain special characters that must be encoded to successfully call the API. To avoid errors with SKUs when
+      # encoding URLs, refer to [URL Encoding](https://developer-docs.amazon.com/sp-api/docs/url-encoding).
+      #
+      # @note This operation can make a static sandbox call.
+      # @param seller_id [String] A selling partner identifier, such as a merchant account or vendor code.
+      # @param sku [String] A selling partner provided identifier for an Amazon listing.
+      # @param marketplace_ids [Array<String>] A comma-delimited list of Amazon marketplace identifiers for the request.
+      # @param included_data [Array<String>] A comma-delimited list of data sets to include in the response. Default:
+      #   `issues`.
+      # @param mode [String] The mode of operation for the request.
+      # @param issue_locale [String] A locale for localization of issues. When not provided, the default language code
+      #   of the first marketplace is used. Examples: `en_US`, `fr_CA`, `fr_FR`. Localized messages default to `en_US`
+      #   when a localization is not available in the specified locale.
+      # @param body [Hash] The request body schema for the `patchListingsItem` operation.
+      # @param rate_limit [Float] Requests per second
+      # @return [Hash] The API response
+      def patch_listings_item(seller_id, sku, marketplace_ids, body, included_data: ["issues"], mode: nil,
+        issue_locale: nil, rate_limit: 5.0)
+        path = "/listings/2021-08-01/items/#{seller_id}/#{sku}"
+        params = {
+          "marketplaceIds" => marketplace_ids,
+          "includedData" => included_data,
+          "mode" => mode,
+          "issueLocale" => issue_locale,
+        }.compact
+
+        meter(rate_limit).patch(path, body:, params:)
+      end
+
+      # Creates or fully updates an existing listings item for a selling partner. **Note:** This operation has a
+      # throttling rate of one request per second when `mode` is `VALIDATION_PREVIEW`. **Note:** The parameters
+      # associated with this operation may contain special characters that must be encoded to successfully call the API.
+      # To avoid errors with SKUs when encoding URLs, refer to [URL
+      # Encoding](https://developer-docs.amazon.com/sp-api/docs/url-encoding).
+      #
+      # @note This operation can make a static sandbox call.
+      # @param seller_id [String] A selling partner identifier, such as a merchant account or vendor code.
+      # @param sku [String] A selling partner provided identifier for an Amazon listing.
+      # @param marketplace_ids [Array<String>] A comma-delimited list of Amazon marketplace identifiers for the request.
+      # @param included_data [Array<String>] A comma-delimited list of data sets to include in the response. Default:
+      #   `issues`.
+      # @param mode [String] The mode of operation for the request.
+      # @param issue_locale [String] A locale for localization of issues. When not provided, the default language code
+      #   of the first marketplace is used. Examples: `en_US`, `fr_CA`, `fr_FR`. Localized messages default to `en_US`
+      #   when a localization is not available in the specified locale.
+      # @param body [Hash] The request body schema for the `putListingsItem` operation.
+      # @param rate_limit [Float] Requests per second
+      # @return [Hash] The API response
+      def put_listings_item(seller_id, sku, marketplace_ids, body, included_data: ["issues"], mode: nil,
+        issue_locale: nil, rate_limit: 5.0)
+        path = "/listings/2021-08-01/items/#{seller_id}/#{sku}"
+        params = {
+          "marketplaceIds" => marketplace_ids,
+          "includedData" => included_data,
+          "mode" => mode,
+          "issueLocale" => issue_locale,
+        }.compact
+
+        meter(rate_limit).put(path, body:, params:)
+      end
+
+      # Search for and return list of listings items and respective details for a selling partner.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param seller_id [String] A selling partner identifier, such as a merchant account or vendor code.
+      # @param marketplace_ids [Array<String>] A comma-delimited list of Amazon marketplace identifiers for the request.
+      # @param identifiers [Array<String>] A comma-delimited list of product identifiers to search for listings items
+      #   by. **Note**: 1. Required when `identifiersType` is provided.
+      # @param identifiers_type [String] Type of product identifiers to search for listings items by. **Note**: 1.
+      #   Required when `identifiers` is provided.
+      # @param page_size [Integer] Number of results to be returned per page.
+      # @param page_token [String] A token to fetch a certain page when there are multiple pages worth of results.
+      # @param included_data [Array<String>] A comma-delimited list of data sets to include in the response. Default:
+      #   summaries.
+      # @param issue_locale [String] A locale for localization of issues. When not provided, the default language code
+      #   of the first marketplace is used. Examples: "en_US", "fr_CA", "fr_FR". Localized messages default to "en_US"
+      #   when a localization is not available in the specified locale.
+      # @param rate_limit [Float] Requests per second
+      # @return [Hash] The API response
+      def search_listings_items(seller_id, marketplace_ids, identifiers: nil, identifiers_type: nil, page_size: 10,
+        page_token: nil, included_data: ["summaries"], issue_locale: nil, rate_limit: 5.0)
+        path = "/listings/2021-08-01/items/#{seller_id}"
+        params = {
+          "marketplaceIds" => marketplace_ids,
+          "identifiers" => identifiers,
+          "identifiersType" => identifiers_type,
+          "pageSize" => page_size,
+          "pageToken" => page_token,
+          "includedData" => included_data,
+          "issueLocale" => issue_locale,
+        }.compact
+
+        meter(rate_limit).get(path, params:)
+      end
+    end
+  end
+end

data/lib/peddler/api/listings_restrictions_2021_08_01.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+require "peddler/api"
+
+module Peddler
+  class << self
+    def listings_restrictions_2021_08_01(...)
+      API::ListingsRestrictions20210801.new(...)
+    end
+  end
+
+  class API
+    # Selling Partner API for Listings Restrictions
+    #
+    # The Selling Partner API for Listings Restrictions provides programmatic access to restrictions on Amazon catalog
+    # listings. For more information, see the
+    # {https://developer-docs.amazon.com/sp-api/docs/listings-restrictions-api-v2021-08-01-use-case-guide Listings
+    # Restrictions API Use Case Guide}.
+    class ListingsRestrictions20210801 < API
+      # Returns listing restrictions for an item in the Amazon Catalog.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param asin [String] The Amazon Standard Identification Number (ASIN) of the item.
+      # @param condition_type [String] The condition used to filter restrictions.
+      # @param seller_id [String] A selling partner identifier, such as a merchant account.
+      # @param marketplace_ids [Array<String>] A comma-delimited list of Amazon marketplace identifiers for the request.
+      # @param reason_locale [String] A locale for reason text localization. When not provided, the default language
+      #   code of the first marketplace is used. Examples: "en_US", "fr_CA", "fr_FR". Localized messages default to
+      #   "en_US" when a localization is not available in the specified locale.
+      # @param rate_limit [Float] Requests per second
+      # @return [Hash] The API response
+      def get_listings_restrictions(asin, seller_id, marketplace_ids, condition_type: nil, reason_locale: nil,
+        rate_limit: 5.0)
+        path = "/listings/2021-08-01/restrictions"
+        params = {
+          "asin" => asin,
+          "conditionType" => condition_type,
+          "sellerId" => seller_id,
+          "marketplaceIds" => marketplace_ids,
+          "reasonLocale" => reason_locale,
+        }.compact
+
+        meter(rate_limit).get(path, params:)
+      end
+    end
+  end
+end

data/lib/peddler/api/merchant_fulfillment_v0.rb

@@ -0,0 +1,80 @@
+# frozen_string_literal: true
+
+require "peddler/api"
+
+module Peddler
+  class << self
+    def merchant_fulfillment_v0(...)
+      API::MerchantFulfillmentV0.new(...)
+    end
+  end
+
+  class API
+    # Selling Partner API for Merchant Fulfillment
+    #
+    # The Selling Partner API for Merchant Fulfillment helps you build applications that let sellers purchase shipping
+    # for non-Prime and Prime orders using Amazon’s Buy Shipping Services.
+    class MerchantFulfillmentV0 < API
+      # Returns a list of shipping service offers that satisfy the specified shipment request details.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param body [Hash] Request schema for GetEligibleShipmentServices operation.
+      # @param rate_limit [Float] Requests per second
+      # @return [Hash] The API response
+      def get_eligible_shipment_services(body, rate_limit: 5.0)
+        path = "/mfn/v0/eligibleShippingServices"
+
+        meter(rate_limit).post(path, body:)
+      end
+
+      # Returns the shipment information for an existing shipment.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param shipment_id [String] The Amazon-defined shipment identifier for the shipment.
+      # @param rate_limit [Float] Requests per second
+      # @return [Hash] The API response
+      def get_shipment(shipment_id, rate_limit: 1.0)
+        path = "/mfn/v0/shipments/#{shipment_id}"
+
+        meter(rate_limit).get(path)
+      end
+
+      # Cancel the shipment indicated by the specified shipment identifier.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param shipment_id [String] The Amazon-defined shipment identifier for the shipment to cancel.
+      # @param rate_limit [Float] Requests per second
+      # @return [Hash] The API response
+      def cancel_shipment(shipment_id, rate_limit: 1.0)
+        path = "/mfn/v0/shipments/#{shipment_id}"
+
+        meter(rate_limit).delete(path)
+      end
+
+      # Create a shipment with the information provided.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param body [Hash] Request schema for CreateShipment operation.
+      # @param rate_limit [Float] Requests per second
+      # @return [Hash] The API response
+      def create_shipment(body, rate_limit: 1.0)
+        path = "/mfn/v0/shipments"
+
+        meter(rate_limit).post(path, body:)
+      end
+
+      # Gets a list of additional seller inputs required for a ship method. This is generally used for international
+      # shipping.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param body [Hash] Request schema for GetAdditionalSellerInputs operation.
+      # @param rate_limit [Float] Requests per second
+      # @return [Hash] The API response
+      def get_additional_seller_inputs(body, rate_limit: 1.0)
+        path = "/mfn/v0/additionalSellerInputs"
+
+        meter(rate_limit).post(path, body:)
+      end
+    end
+  end
+end