peddler 2.4.5 → 3.0.0

data/lib/peddler/api/shipping_v2.rb

@@ -0,0 +1,319 @@
+# frozen_string_literal: true
+
+require "peddler/api"
+
+module Peddler
+  class << self
+    def shipping_v2(...)
+      API::ShippingV2.new(...)
+    end
+  end
+
+  class API
+    # Amazon Shipping API
+    #
+    # The Amazon Shipping API is designed to support outbound shipping use cases both for orders originating on
+    # Amazon-owned marketplaces as well as external channels/marketplaces. With these APIs, you can request shipping
+    # rates, create shipments, cancel shipments, and track shipments.
+    class ShippingV2 < API
+      # Returns the available shipping service offerings.
+      #
+      # @note This operation can make a dynamic sandbox call.
+      # @param body [Hash]
+      # @param x_amzn_shipping_business_id [String] Amazon shipping business to assume for this request. The default is
+      #   AmazonShipping_UK.
+      # @param rate_limit [Float] Requests per second
+      # @return [Hash] The API response
+      def get_rates(body, x_amzn_shipping_business_id: nil, rate_limit: 80.0)
+        path = "/shipping/v2/shipments/rates"
+
+        meter(rate_limit).post(path, body:)
+      end
+
+      # Purchases the shipping service for a shipment using the best fit service offering. Returns purchase related
+      # details and documents.
+      #
+      # @param body [Hash]
+      # @param x_amzn_idempotency_key [String] A unique value which the server uses to recognize subsequent retries of
+      #   the same request.
+      # @param locale [String] The IETF Language Tag. Note that this only supports the primary language subtag with one
+      #   secondary language subtag (i.e. en-US, fr-CA). The secondary language subtag is almost always a regional
+      #   designation. This does not support additional subtags beyond the primary and secondary language subtags.
+      # @param x_amzn_shipping_business_id [String] Amazon shipping business to assume for this request. The default is
+      #   AmazonShipping_UK.
+      # @param rate_limit [Float] Requests per second
+      # @return [Hash] The API response
+      def direct_purchase_shipment(body, x_amzn_idempotency_key: nil, locale: nil, x_amzn_shipping_business_id: nil,
+        rate_limit: 80.0)
+        cannot_sandbox!
+
+        path = "/shipping/v2/shipments/directPurchase"
+
+        meter(rate_limit).post(path, body:)
+      end
+
+      # Purchases a shipping service and returns purchase related details and documents. Note: You must complete the
+      # purchase within 10 minutes of rate creation by the shipping service provider. If you make the request after the
+      # 10 minutes have expired, you will receive an error response with the error code equal to "TOKEN_EXPIRED". If you
+      # receive this error response, you must get the rates for the shipment again.
+      #
+      # @note This operation can make a dynamic sandbox call.
+      # @param body [Hash]
+      # @param x_amzn_idempotency_key [String] A unique value which the server uses to recognize subsequent retries of
+      #   the same request.
+      # @param x_amzn_shipping_business_id [String] Amazon shipping business to assume for this request. The default is
+      #   AmazonShipping_UK.
+      # @param rate_limit [Float] Requests per second
+      # @return [Hash] The API response
+      def purchase_shipment(body, x_amzn_idempotency_key: nil, x_amzn_shipping_business_id: nil, rate_limit: 80.0)
+        path = "/shipping/v2/shipments"
+
+        meter(rate_limit).post(path, body:)
+      end
+
+      # Purchases a shipping service identifier and returns purchase-related details and documents.
+      #
+      # @note This operation can make a dynamic sandbox call.
+      # @param body [Hash]
+      # @param x_amzn_shipping_business_id [String] Amazon shipping business to assume for this request. The default is
+      #   AmazonShipping_UK.
+      # @param rate_limit [Float] Requests per second
+      # @return [Hash] The API response
+      def one_click_shipment(body, x_amzn_shipping_business_id: nil, rate_limit: 80.0)
+        path = "/shipping/v2/oneClickShipment"
+
+        meter(rate_limit).post(path, body:)
+      end
+
+      # Returns tracking information for a purchased shipment.
+      #
+      # @note This operation can make a dynamic sandbox call.
+      # @param tracking_id [String] A carrier-generated tracking identifier originally returned by the purchaseShipment
+      #   operation.
+      # @param carrier_id [String] A carrier identifier originally returned by the getRates operation for the selected
+      #   rate.
+      # @param x_amzn_shipping_business_id [String] Amazon shipping business to assume for this request. The default is
+      #   AmazonShipping_UK.
+      # @param rate_limit [Float] Requests per second
+      # @return [Hash] The API response
+      def get_tracking(tracking_id, carrier_id, x_amzn_shipping_business_id: nil, rate_limit: 80.0)
+        path = "/shipping/v2/tracking"
+        params = {
+          "trackingId" => tracking_id,
+          "carrierId" => carrier_id,
+        }.compact
+
+        meter(rate_limit).get(path, params:)
+      end
+
+      # Returns the shipping documents associated with a package in a shipment.
+      #
+      # @note This operation can make a dynamic sandbox call.
+      # @param shipment_id [String] The shipment identifier originally returned by the purchaseShipment operation.
+      # @param package_client_reference_id [String] The package client reference identifier originally provided in the
+      #   request body parameter for the getRates operation.
+      # @param format [String] The file format of the document. Must be one of the supported formats returned by the
+      #   getRates operation.
+      # @param dpi [Number] The resolution of the document (for example, 300 means 300 dots per inch). Must be one of
+      #   the supported resolutions returned in the response to the getRates operation.
+      # @param x_amzn_shipping_business_id [String] Amazon shipping business to assume for this request. The default is
+      #   AmazonShipping_UK.
+      # @param rate_limit [Float] Requests per second
+      # @return [Hash] The API response
+      def get_shipment_documents(shipment_id, package_client_reference_id, format: nil, dpi: nil,
+        x_amzn_shipping_business_id: nil, rate_limit: 80.0)
+        path = "/shipping/v2/shipments/#{shipment_id}/documents"
+        params = {
+          "packageClientReferenceId" => package_client_reference_id,
+          "format" => format,
+          "dpi" => dpi,
+        }.compact
+
+        meter(rate_limit).get(path, params:)
+      end
+
+      # Cancels a purchased shipment. Returns an empty object if the shipment is successfully cancelled.
+      #
+      # @note This operation can make a dynamic sandbox call.
+      # @param shipment_id [String] The shipment identifier originally returned by the purchaseShipment operation.
+      # @param x_amzn_shipping_business_id [String] Amazon shipping business to assume for this request. The default is
+      #   AmazonShipping_UK.
+      # @param rate_limit [Float] Requests per second
+      # @return [Hash] The API response
+      def cancel_shipment(shipment_id, x_amzn_shipping_business_id: nil, rate_limit: 80.0)
+        path = "/shipping/v2/shipments/#{shipment_id}/cancel"
+
+        meter(rate_limit).put(path)
+      end
+
+      # Returns the JSON schema to use for providing additional inputs when needed to purchase a shipping offering. Call
+      # the getAdditionalInputs operation when the response to a previous call to the getRates operation indicates that
+      # additional inputs are required for the rate (shipping offering) that you want to purchase.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param request_token [String] The request token returned in the response to the getRates operation.
+      # @param rate_id [String] The rate identifier for the shipping offering (rate) returned in the response to the
+      #   getRates operation.
+      # @param x_amzn_shipping_business_id [String] Amazon shipping business to assume for this request. The default is
+      #   AmazonShipping_UK.
+      # @param rate_limit [Float] Requests per second
+      # @return [Hash] The API response
+      def get_additional_inputs(request_token, rate_id, x_amzn_shipping_business_id: nil, rate_limit: 80.0)
+        path = "/shipping/v2/shipments/additionalInputs/schema"
+        params = {
+          "requestToken" => request_token,
+          "rateId" => rate_id,
+        }.compact
+
+        meter(rate_limit).get(path, params:)
+      end
+
+      # This API will return a list of input schema required to register a shipper account with the carrier.
+      #
+      # @param x_amzn_shipping_business_id [String] Amazon shipping business to assume for this request. The default is
+      #   AmazonShipping_UK.
+      # @param rate_limit [Float] Requests per second
+      # @return [Hash] The API response
+      def get_carrier_account_form_inputs(x_amzn_shipping_business_id: nil, rate_limit: 80.0)
+        cannot_sandbox!
+
+        path = "/shipping/v2/carrierAccountFormInputs"
+
+        meter(rate_limit).get(path)
+      end
+
+      # This API will return Get all carrier accounts for a merchant.
+      #
+      # @param body [Hash]
+      # @param x_amzn_shipping_business_id [String] Amazon shipping business to assume for this request. The default is
+      #   AmazonShipping_UK.
+      # @param rate_limit [Float] Requests per second
+      # @return [Hash] The API response
+      def get_carrier_accounts(body, x_amzn_shipping_business_id: nil, rate_limit: 80.0)
+        cannot_sandbox!
+
+        path = "/shipping/v2/carrierAccounts"
+
+        meter(rate_limit).put(path, body:)
+      end
+
+      # This API associates/links the specified carrier account with the merchant.
+      #
+      # @param carrier_id [String] The unique identifier associated with the carrier account.
+      # @param body [Hash]
+      # @param x_amzn_shipping_business_id [String] Amazon shipping business to assume for this request. The default is
+      #   AmazonShipping_UK.
+      # @param rate_limit [Float] Requests per second
+      # @return [Hash] The API response
+      def link_carrier_account(carrier_id, body, x_amzn_shipping_business_id: nil, rate_limit: 80.0)
+        cannot_sandbox!
+
+        path = "/shipping/v2/carrierAccounts/#{carrier_id}"
+
+        meter(rate_limit).put(path, body:)
+      end
+
+      # This API Unlink the specified carrier account with the merchant.
+      #
+      # @param carrier_id [String] carrier Id to unlink with merchant.
+      # @param body [Hash]
+      # @param x_amzn_shipping_business_id [String] Amazon shipping business to assume for this request. The default is
+      #   AmazonShipping_UK.
+      # @param rate_limit [Float] Requests per second
+      # @return [Hash] The API response
+      def unlink_carrier_account(carrier_id, body, x_amzn_shipping_business_id: nil, rate_limit: 80.0)
+        cannot_sandbox!
+
+        path = "/shipping/v2/carrierAccounts/#{carrier_id}/unlink"
+
+        meter(rate_limit).put(path, body:)
+      end
+
+      # This API Call to generate the collection form.
+      #
+      # @param body [Hash]
+      # @param x_amzn_idempotency_key [String] A unique value which the server uses to recognize subsequent retries of
+      #   the same request.
+      # @param x_amzn_shipping_business_id [String] Amazon shipping business to assume for this request. The default is
+      #   AmazonShipping_UK.
+      # @param rate_limit [Float] Requests per second
+      # @return [Hash] The API response
+      def generate_collection_form(body, x_amzn_idempotency_key: nil, x_amzn_shipping_business_id: nil,
+        rate_limit: 80.0)
+        cannot_sandbox!
+
+        path = "/shipping/v2/collectionForms"
+
+        meter(rate_limit).post(path, body:)
+      end
+
+      # This API Call to get the history of the previously generated collection forms.
+      #
+      # @param body [Hash]
+      # @param x_amzn_shipping_business_id [String] Amazon shipping business to assume for this request. The default is
+      #   AmazonShipping_UK.
+      # @param rate_limit [Float] Requests per second
+      # @return [Hash] The API response
+      def get_collection_form_history(body, x_amzn_shipping_business_id: nil, rate_limit: 80.0)
+        cannot_sandbox!
+
+        path = "/shipping/v2/collectionForms/history"
+
+        meter(rate_limit).put(path, body:)
+      end
+
+      # This API Get all unmanifested carriers with shipment locations. Any locations which has unmanifested shipments
+      # with an eligible carrier for manifesting shall be returned.
+      #
+      # @param body [Hash]
+      # @param x_amzn_shipping_business_id [String] Amazon shipping business to assume for this request. The default is
+      #   AmazonShipping_UK.
+      # @param rate_limit [Float] Requests per second
+      # @return [Hash] The API response
+      def get_unmanifested_shipments(body, x_amzn_shipping_business_id: nil, rate_limit: 80.0)
+        cannot_sandbox!
+
+        path = "/shipping/v2/unmanifestedShipments"
+
+        meter(rate_limit).put(path, body:)
+      end
+
+      # This API reprint a collection form.
+      #
+      # @param collection_form_id [String] collection form Id to reprint a collection.
+      # @param x_amzn_shipping_business_id [String] Amazon shipping business to assume for this request. The default is
+      #   AmazonShipping_UK.
+      # @param rate_limit [Float] Requests per second
+      # @return [Hash] The API response
+      def get_collection_form(collection_form_id, x_amzn_shipping_business_id: nil, rate_limit: 80.0)
+        cannot_sandbox!
+
+        path = "/shipping/v2/collectionForms/#{collection_form_id}"
+
+        meter(rate_limit).get(path)
+      end
+
+      # Returns a list of access points in proximity of input postal code.
+      #
+      # @note This operation can make a dynamic sandbox call.
+      # @param access_point_types [Array<String>]
+      # @param country_code [String]
+      # @param postal_code [String]
+      # @param x_amzn_shipping_business_id [String] Amazon shipping business to assume for this request. The default is
+      #   AmazonShipping_UK.
+      # @param rate_limit [Float] Requests per second
+      # @return [Hash] The API response
+      def get_access_points(access_point_types, country_code, postal_code, x_amzn_shipping_business_id: nil,
+        rate_limit: 80.0)
+        path = "/shipping/v2/accessPoints"
+        params = {
+          "accessPointTypes" => access_point_types,
+          "countryCode" => country_code,
+          "postalCode" => postal_code,
+        }.compact
+
+        meter(rate_limit).get(path, params:)
+      end
+    end
+  end
+end

data/lib/peddler/api/solicitations_v1.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+require "peddler/api"
+
+module Peddler
+  class << self
+    def solicitations_v1(...)
+      API::SolicitationsV1.new(...)
+    end
+  end
+
+  class API
+    # Selling Partner API for Solicitations
+    #
+    # With the Solicitations API you can build applications that send non-critical solicitations to buyers. You can get
+    # a list of solicitation types that are available for an order that you specify, then call an operation that sends a
+    # solicitation to the buyer for that order. Buyers cannot respond to solicitations sent by this API, and these
+    # solicitations do not appear in the Messaging section of Seller Central or in the recipient's Message Center. The
+    # Solicitations API returns responses that are formed according to the <a
+    # href=https://tools.ietf.org/html/draft-kelly-json-hal-08>JSON Hypertext Application Language</a> (HAL) standard.
+    class SolicitationsV1 < API
+      # Returns a list of solicitation types that are available for an order that you specify. A solicitation type is
+      # represented by an actions object, which contains a path and query parameter(s). You can use the path and
+      # parameter(s) to call an operation that sends a solicitation. Currently only the
+      # productReviewAndSellerFeedbackSolicitation solicitation type is available.
+      #
+      # @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 solicitation 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 rate_limit [Float] Requests per second
+      # @return [Hash] The API response
+      def get_solicitation_actions_for_order(amazon_order_id, marketplace_ids, rate_limit: 1.0)
+        path = "/solicitations/v1/orders/#{amazon_order_id}"
+        params = {
+          "marketplaceIds" => marketplace_ids,
+        }.compact
+
+        meter(rate_limit).get(path, params:)
+      end
+
+      # Sends a solicitation to a buyer asking for seller feedback and a product review for the specified order. Send
+      # only one productReviewAndSellerFeedback or free form proactive message per 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 solicitation 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 rate_limit [Float] Requests per second
+      # @return [Hash] The API response
+      def create_product_review_and_seller_feedback_solicitation(amazon_order_id, marketplace_ids, rate_limit: 1.0)
+        path = "/solicitations/v1/orders/#{amazon_order_id}/solicitations/productReviewAndSellerFeedback"
+        params = {
+          "marketplaceIds" => marketplace_ids,
+        }.compact
+
+        meter(rate_limit).post(path, params:)
+      end
+    end
+  end
+end

data/lib/peddler/api/supply_sources_2020_07_01.rb

@@ -0,0 +1,100 @@
+# frozen_string_literal: true
+
+require "peddler/api"
+
+module Peddler
+  class << self
+    def supply_sources_2020_07_01(...)
+      API::SupplySources20200701.new(...)
+    end
+  end
+
+  class API
+    # Selling Partner API for Supply Sources
+    #
+    # Manage configurations and capabilities of seller supply sources.
+    class SupplySources20200701 < API
+      # The path to retrieve paginated supply sources.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param next_page_token [String] The pagination token to retrieve a specific page of results.
+      # @param page_size [Number] The number of supply sources to return per paginated request.
+      # @param rate_limit [Float] Requests per second
+      # @return [Hash] The API response
+      def get_supply_sources(next_page_token: nil, page_size: 10, rate_limit: nil)
+        path = "/supplySources/2020-07-01/supplySources"
+        params = {
+          "nextPageToken" => next_page_token,
+          "pageSize" => page_size,
+        }.compact
+
+        get(path, params:)
+      end
+
+      # Create a new supply source.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param payload [Hash] A request to create a supply source.
+      # @param rate_limit [Float] Requests per second
+      # @return [Hash] The API response
+      def create_supply_source(payload, rate_limit: nil)
+        path = "/supplySources/2020-07-01/supplySources"
+        body = payload
+
+        post(path, body:)
+      end
+
+      # Retrieve a supply source.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param supply_source_id [String] The unique identifier of a supply source.
+      # @param rate_limit [Float] Requests per second
+      # @return [Hash] The API response
+      def get_supply_source(supply_source_id, rate_limit: nil)
+        path = "/supplySources/2020-07-01/supplySources/#{supply_source_id}"
+
+        get(path)
+      end
+
+      # Update the configuration and capabilities of a supply source.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param supply_source_id [String] The unique identitier of a supply source.
+      # @param payload [Hash]
+      # @param rate_limit [Float] Requests per second
+      # @return [Hash] The API response
+      def update_supply_source(supply_source_id, payload: nil, rate_limit: nil)
+        path = "/supplySources/2020-07-01/supplySources/#{supply_source_id}"
+        body = payload
+
+        put(path, body:)
+      end
+
+      # Archive a supply source, making it inactive. Cannot be undone.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param supply_source_id [String] The unique identifier of a supply source.
+      # @param rate_limit [Float] Requests per second
+      # @return [Hash] The API response
+      def archive_supply_source(supply_source_id, rate_limit: nil)
+        path = "/supplySources/2020-07-01/supplySources/#{supply_source_id}"
+
+        delete(path)
+      end
+
+      # Update the status of a supply source.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param supply_source_id [String] The unique identifier of a supply source.
+      # @param payload [Hash]
+      # @param rate_limit [Float] Requests per second
+      # @return [Hash] The API response
+      def update_supply_source_status(supply_source_id, payload: nil, rate_limit: nil)
+        path = "/supplySources/2020-07-01/supplySources/#{supply_source_id}/status"
+        body = payload
+
+        put(path, body:)
+      end
+    end
+  end
+end

data/lib/peddler/api/tokens_2021_03_01.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+require "peddler/api"
+
+module Peddler
+  class << self
+    def tokens_2021_03_01(...)
+      API::Tokens20210301.new(...)
+    end
+  end
+
+  class API
+    # Selling Partner API for Tokens
+    #
+    # The Selling Partner API for Tokens provides a secure way to access a customer's PII (Personally Identifiable
+    # Information). You can call the Tokens API to get a Restricted Data Token (RDT) for one or more restricted
+    # resources that you specify. The RDT authorizes subsequent calls to restricted operations that correspond to the
+    # restricted resources that you specified. For more information, see the
+    # {https://developer-docs.amazon.com/sp-api/docs/tokens-api-use-case-guide Tokens API Use Case Guide}.
+    class Tokens20210301 < API
+      # Returns a Restricted Data Token (RDT) for one or more restricted resources that you specify. A restricted
+      # resource is the HTTP method and path from a restricted operation that returns Personally Identifiable
+      # Information (PII), plus a dataElements value that indicates the type of PII requested. See the Tokens API Use
+      # Case Guide for a list of restricted operations. Use the RDT returned here as the access token in subsequent
+      # calls to the corresponding restricted operations.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param body [Hash] The restricted data token request details.
+      # @param rate_limit [Float] Requests per second
+      # @return [Hash] The API response
+      def create_restricted_data_token(body, rate_limit: 1.0)
+        path = "/tokens/2021-03-01/restrictedDataToken"
+
+        meter(rate_limit).post(path, body:)
+      end
+    end
+  end
+end

data/lib/peddler/api/uploads_2020_11_01.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+require "peddler/api"
+
+module Peddler
+  class << self
+    def uploads_2020_11_01(...)
+      API::Uploads20201101.new(...)
+    end
+  end
+
+  class API
+    # Selling Partner API for Uploads
+    #
+    # The Uploads API lets you upload files that you can programmatically access using other Selling Partner APIs, such
+    # as the A+ Content API and the Messaging API.
+    class Uploads20201101 < API
+      # Creates an upload destination, returning the information required to upload a file to the destination and to
+      # programmatically access the file.
+      #
+      # @param marketplace_ids [Array<String>] A list of marketplace identifiers. This specifies the marketplaces where
+      #   the upload will be available. Only one marketplace can be specified.
+      # @param content_md5 [String] An MD5 hash of the content to be submitted to the upload destination. This value is
+      #   used to determine if the data has been corrupted or tampered with during transit.
+      # @param resource [String] The resource for the upload destination that you are creating. For example, if you are
+      #   creating an upload destination for the createLegalDisclosure operation of the Messaging API, the `{resource}`
+      #   would be `/messaging/v1/orders/{amazonOrderId}/messages/legalDisclosure`, and the entire path would be
+      #   `/uploads/2020-11-01/uploadDestinations/messaging/v1/orders/{amazonOrderId}/messages/legalDisclosure`. If you
+      #   are creating an upload destination for an Aplus content document, the `{resource}` would be
+      #   `aplus/2020-11-01/contentDocuments` and the path would be
+      #   `/uploads/v1/uploadDestinations/aplus/2020-11-01/contentDocuments`.
+      # @param content_type [String] The content type of the file to be uploaded.
+      # @param rate_limit [Float] Requests per second
+      # @return [Hash] The API response
+      def create_upload_destination_for_resource(marketplace_ids, content_md5, resource, content_type: nil,
+        rate_limit: 10.0)
+        cannot_sandbox!
+
+        path = "/uploads/2020-11-01/uploadDestinations/#{resource}"
+        params = {
+          "marketplaceIds" => marketplace_ids,
+          "contentMD5" => content_md5,
+          "contentType" => content_type,
+        }.compact
+
+        meter(rate_limit).post(path, params:)
+      end
+    end
+  end
+end

data/lib/peddler/api/vendor_direct_fulfillment_inventory_v1.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+require "peddler/api"
+
+module Peddler
+  class << self
+    def vendor_direct_fulfillment_inventory_v1(...)
+      API::VendorDirectFulfillmentInventoryV1.new(...)
+    end
+  end
+
+  class API
+    # Selling Partner API for Direct Fulfillment Inventory Updates
+    #
+    # The Selling Partner API for Direct Fulfillment Inventory Updates provides programmatic access to a direct
+    # fulfillment vendor's inventory updates.
+    class VendorDirectFulfillmentInventoryV1 < API
+      # Submits inventory updates for the specified warehouse for either a partial or full feed of inventory items.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param body [Hash] The request body that contains the inventory update data to submit.
+      # @param warehouse_id [String] Identifier for the warehouse for which to update inventory.
+      # @param rate_limit [Float] Requests per second
+      # @return [Hash] The API response
+      def submit_inventory_update(body, warehouse_id, rate_limit: 10.0)
+        path = "/vendor/directFulfillment/inventory/v1/warehouses/#{warehouse_id}/items"
+
+        meter(rate_limit).post(path, body:)
+      end
+    end
+  end
+end