sp_api_clients 2.0.0

data/lib/amazon_sp_clients/v2/rdt.rb

@@ -0,0 +1,104 @@
+# frozen_string_literal: true
+
+require 'amazon_sp_clients/v2/token'
+
+module AmazonSpClients
+  module V2
+    # Restricted data tokens (RDT). The Tokens API issues a short-lived
+    # token for named restricted resources; a call that returns PII sends
+    # that token instead of the normal access token.
+    #
+    #   client.orders_v0.get_orders(ids, rdt: RDT::ORDERS_AND_ITEMS)
+    #   client.reports_2021.get_report_document(id, rdt: RDT.report_document(id))
+    module RDT
+      # One restricted resource: HTTP method, path template and the PII
+      # data elements wanted. A value object, so equal resources make
+      # equal cache keys.
+      Resource = Data.define(:http_method, :path, :data_elements)
+
+      class Resource
+        # @return [Hash] the shape the Tokens API expects
+        def to_request
+          { method: http_method, path: path, dataElements: data_elements }.compact
+        end
+      end
+
+      # Orders with buyer info and shipping address (v1's :orders).
+      ORDERS = [
+        Resource.new(http_method: 'GET', path: '/orders/v0/orders',
+                     data_elements: %w[buyerInfo shippingAddress].freeze)
+      ].freeze
+
+      # ORDERS plus order items with buyer info (v1's :orders_and_items).
+      ORDERS_AND_ITEMS = [
+        *ORDERS,
+        Resource.new(http_method: 'GET', path: '/orders/v0/orders/{orderId}/orderItems',
+                     data_elements: %w[buyerInfo].freeze)
+      ].freeze
+
+      # @param http_method [String] e.g. 'GET'
+      # @param path [String] path template, e.g. '/orders/v0/orders/{orderId}'
+      # @param data_elements [Array<String>, nil] PII fields wanted
+      # @return [Resource]
+      def self.resource(http_method, path, data_elements = nil)
+        Resource.new(http_method: http_method, path: path, data_elements: data_elements)
+      end
+
+      # Path prefix of getReportDocument in reports_2021. A token is only
+      # good for the exact path it names, document id included.
+      REPORT_DOCUMENTS_PATH = '/reports/2021-06-30/documents'
+
+      # The resource list for a restricted report document (PII report
+      # types such as order and returns reports).
+      #
+      # @param document_id [String] the reportDocumentId
+      # @return [Array<Resource>]
+      def self.report_document(document_id)
+        [resource('GET', "#{REPORT_DOCUMENTS_PATH}/#{document_id}")].freeze
+      end
+
+      # Restricted tokens per resource list, with expiry. One lock, held
+      # while a missing token is fetched, so concurrent callers for the
+      # same resources cause one Tokens API call. The fetch block runs
+      # inside the lock and must not come back to this cache.
+      class Cache
+        def initialize
+          @entries = {}
+          @mutex = Mutex.new
+        end
+
+        # @param resources [Array<Resource>]
+        # @yieldreturn [Token] a fresh restricted token, asked for on a miss
+        # @return [String] the restricted data token
+        def fetch(resources)
+          key = cache_key(resources)
+
+          @mutex.synchronize do
+            entry = @entries[key]
+            return entry.access_token if entry && !entry.expired?
+
+            sweep
+            token = yield
+            @entries[key] = token
+            token.access_token
+          end
+        end
+
+        # @return [Integer] cached tokens, expired ones included until the next miss
+        def size = @mutex.synchronize { @entries.size }
+
+        private
+
+        # A frozen copy, so the caller's own array is left alone.
+        def cache_key(resources)
+          list = Array(resources)
+          list.frozen? ? list : list.dup.freeze
+        end
+
+        def sweep
+          @entries.delete_if { |_, token| token.expired? }
+        end
+      end
+    end
+  end
+end

data/lib/amazon_sp_clients/v2/token.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+require 'amazon_sp_clients/v2/errors'
+
+module AmazonSpClients
+  module V2
+    # An access token with its expiry, as returned by LWA or by the
+    # Tokens API (restricted data tokens). Frozen: a refresh swaps the
+    # whole object, so a reader never sees a token paired with another
+    # exchange's expiry.
+    Token = Data.define(:access_token, :token_type, :expires_in, :expires_at, :refresh_token)
+
+    class Token
+      # Seconds before the real expiry at which the token counts as
+      # expired, so a request started just before it never carries a
+      # dead token.
+      EXPIRY_SKEW = 60
+
+      # @param now [Time]
+      # @return [Boolean] true within EXPIRY_SKEW of expiry, or when
+      #   the token has no expiry at all
+      def expired?(now = Time.now.utc)
+        return true if expires_at.nil?
+
+        now >= expires_at - EXPIRY_SKEW
+      end
+
+      # Token values stay out of consoles and error trackers.
+      #
+      # @return [String]
+      def inspect
+        fields = to_h.merge(access_token: access_token && FILTERED,
+                            refresh_token: refresh_token && FILTERED)
+
+        "#<#{self.class.name} #{fields.map { |k, v| "#{k}=#{v.inspect}" }.join(' ')}>"
+      end
+    end
+  end
+end

data/lib/amazon_sp_clients/v2.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+require 'amazon_sp_clients/version'
+require 'amazon_sp_clients/marketplaces'
+require 'amazon_sp_clients/api_error'
+require 'amazon_sp_clients/api_response'
+
+require 'amazon_sp_clients/v2/errors'
+require 'amazon_sp_clients/v2/config'
+require 'amazon_sp_clients/v2/token'
+require 'amazon_sp_clients/v2/error_mapper'
+require 'amazon_sp_clients/v2/lwa'
+require 'amazon_sp_clients/v2/credentials'
+require 'amazon_sp_clients/v2/rdt'
+require 'amazon_sp_clients/v2/documents'
+require 'amazon_sp_clients/v2/api'
+require 'amazon_sp_clients/v2/client'
+require 'amazon_sp_clients/v2/apis'
+
+# Ruby clients for the Amazon Selling Partner API.
+module AmazonSpClients
+  # The second-generation client: explicit per-client configuration, a
+  # thread-safe token source, first-class restricted data tokens and
+  # typed errors. Loads without the v1 code.
+  #
+  #   require 'amazon_sp_clients/v2'
+  #
+  #   config = AmazonSpClients::V2::Config.new(endpoint: 'na')
+  #   client = AmazonSpClients::V2::Client.new(config) { current_access_token }
+  #   client.orders_v0.get_orders(marketplace_ids, created_after: since)
+  module V2
+  end
+end

data/lib/amazon_sp_clients/version.rb

@@ -0,0 +1,3 @@
+module AmazonSpClients
+  VERSION = '2.0.0'.freeze
+end

data/lib/amazon_sp_clients.rb

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+
+require 'amazon_sp_clients/version'
+require 'amazon_sp_clients/marketplaces'
+
+require 'amazon_sp_clients/middlewares/raise_error'
+
+require 'amazon_sp_clients/token_exchange_auth'
+require 'amazon_sp_clients/session'
+
+require 'amazon_sp_clients/api_client'
+require 'amazon_sp_clients/api_error'
+require 'amazon_sp_clients/configuration'
+require 'amazon_sp_clients/api_response'
+
+require 'amazon_sp_clients/uploader'
+
+require 'faraday'
+require 'httpclient'
+
+module AmazonSpClients
+  # Normal calls
+  def self.new_session(refresh_token)
+    AmazonSpClients::Session.new.authenticate(refresh_token)
+  end
+
+  # Grantless calls
+  def self.new_migration_session
+    scope = 'sellingpartnerapi::migration'
+    AmazonSpClients::Session.new.authenticate_grantless(scope)
+  end
+
+  def self.new_callback_session(&)
+    AmazonSpClients::Session.new.with_callback(&)
+  end
+
+  def self.upload_feed_data(
+    feed_document_response,
+    document_content_type,
+    payload
+  )
+    uploader = AmazonSpClients::Uploader.new
+    uploader.upload(feed_document_response, document_content_type, payload)
+
+    uploader.response
+  end
+
+  def self.download_feed_report(feed_processing_report)
+    AmazonSpClients::Downloader.new(feed_processing_report).download
+  end
+
+  def self.download_report_document(doc_params)
+    url = doc_params.fetch(:url)
+    conn =
+      Faraday.new(request: { timeout: configure.timeout }) do |c|
+        c.use AmazonSpClients::Middlewares::RaiseError, { service: :uploads }
+      end
+
+    conn.get(url)&.body
+  end
+
+  def self.configure
+    if block_given?
+      yield(Configuration.default)
+    else
+      Configuration.default
+    end
+  end
+end

data/lib/sp_api_clients.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+# The gem is sp_api_clients; the code keeps its AmazonSpClients name.
+# Bundler requires a gem by its name, so this file points it at the
+# real entry point. `require 'amazon_sp_clients/v2'` loads V2 alone.
+require 'amazon_sp_clients'

data/sp_api_clients.gemspec

@@ -0,0 +1,53 @@
+require_relative 'lib/amazon_sp_clients/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'sp_api_clients'
+  spec.version       = AmazonSpClients::VERSION
+  spec.authors       = ['Dropstream']
+  spec.email         = ['351015+nina-saule@users.noreply.github.com']
+
+  spec.summary       = 'Experimental Ruby clients for the Amazon Selling Partner API'
+  spec.description   = 'Ruby clients for the Amazon Selling Partner API (SP-API), generated from ' \
+                       "Amazon's models. Experimental; consider peddler for production use. " \
+                       'Not affiliated with Amazon.'
+  spec.homepage      = 'https://github.com/dropstream/amazon_sp_clients'
+  spec.license       = 'MIT'
+  spec.required_ruby_version = Gem::Requirement.new('>= 3.3')
+
+  # Releases go to rubygems.org through the tag workflow, never from a laptop.
+  spec.metadata['allowed_push_host'] = 'https://rubygems.org'
+
+  spec.metadata['homepage_uri'] = spec.homepage
+  spec.metadata['source_code_uri'] = spec.homepage
+  spec.metadata['changelog_uri'] = "#{spec.homepage}/blob/master/CHANGELOG.md"
+  spec.metadata['rubygems_mfa_required'] = 'true'
+
+  # Only lib/, vendor/, the gemspec and the top-level docs ship. Tests,
+  # the generator, CI config, dotfiles and the dev tooling stay behind.
+  dev_files = %r{
+    ^(test|spec|features|amzn-models|gemfiles|bin)/ |
+    ^lib/generator |
+    ^\. |
+    ^(Gemfile(\.lock)?|Rakefile|CLAUDE\.md|codegen-config\.yml|selling-partner-api-models\.sha)$
+  }x
+  spec.files = Dir.chdir(File.expand_path(__dir__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(dev_files) }
+  end
+  spec.bindir        = 'exe'
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  spec.add_dependency 'faraday', '>= 1.10', '< 3'
+  spec.add_dependency 'faraday-httpclient', '>= 1.0', '< 3'
+  spec.add_dependency 'faraday-retry', '>= 1.0', '< 3'
+  spec.add_dependency 'httpclient'
+  spec.add_dependency 'multi_xml'
+
+  spec.add_development_dependency 'dotenv'
+  spec.add_development_dependency 'rake'
+  spec.add_development_dependency 'rspec'
+  spec.add_development_dependency 'rubocop', '~> 1.86'
+  spec.add_development_dependency 'timecop'
+  spec.add_development_dependency 'webmock'
+  spec.add_development_dependency 'yard'
+end

data/vendor/fba_inventory/lib/sp_fba_inventory/api/fba_inventory_api.rb

@@ -0,0 +1,289 @@
+=begin
+#Selling Partner API for FBA Inventory
+
+#The Selling Partner API for FBA Inventory lets you programmatically retrieve information about inventory in Amazon's fulfillment network.
+
+OpenAPI spec version: v1
+
+Generated by: lib/generator (bundle exec rake generate)
+=end
+
+module AmazonSpClients
+  module SpFbaInventory
+    class FbaInventoryApi
+      attr_accessor :api_client
+
+      def initialize(session)
+        @api_client = AmazonSpClients::ApiClient.new(session)
+      end
+      # Requests that Amazon add items to the Sandbox Inventory with desired amount of quantity in the sandbox environment. This is a sandbox-only operation and must be directed to a sandbox endpoint. Refer to [Selling Partner API sandbox](https://developer-docs.amazon.com/sp-api/docs/the-selling-partner-api-sandbox) for more information.
+      # @param body List of items to add to Sandbox inventory.
+      # @param x_amzn_idempotency_token A unique token/requestId provided with each call to ensure idempotency.
+      # @param [Hash] opts the optional parameters
+      # @return [AddInventoryResponse]
+      def add_inventory(body, x_amzn_idempotency_token, opts = {})
+        data = add_inventory_with_http_info(body, x_amzn_idempotency_token, opts)
+        return data
+      end
+
+      # Requests that Amazon add items to the Sandbox Inventory with desired amount of quantity in the sandbox environment. This is a sandbox-only operation and must be directed to a sandbox endpoint. Refer to [Selling Partner API sandbox](https://developer-docs.amazon.com/sp-api/docs/the-selling-partner-api-sandbox) for more information.
+      # @param body List of items to add to Sandbox inventory.
+      # @param x_amzn_idempotency_token A unique token/requestId provided with each call to ensure idempotency.
+      # @param [Hash] opts the optional parameters
+      # @return [Array<(AddInventoryResponse)>] AddInventoryResponse data, response status code and response headers
+      def add_inventory_with_http_info(body, x_amzn_idempotency_token, opts = {})
+        if @api_client.config.debugging
+          @api_client.config.logger.debug 'Calling API: FbaInventoryApi.add_inventory ...'
+        end
+        # verify the required parameter 'body' is set
+        if @api_client.config.client_side_validation && body.nil?
+          fail ArgumentError, "Missing the required parameter 'body' when calling FbaInventoryApi.add_inventory"
+        end
+        # verify the required parameter 'x_amzn_idempotency_token' is set
+        if @api_client.config.client_side_validation && x_amzn_idempotency_token.nil?
+          fail ArgumentError, "Missing the required parameter 'x_amzn_idempotency_token' when calling FbaInventoryApi.add_inventory"
+        end
+        # resource path
+        local_var_path = '/fba/inventory/v1/items/inventory'
+
+        # query parameters
+        query_params = opts[:query_params] || {}
+
+        # header parameters
+        header_params = opts[:header_params] || {}
+        # HTTP header 'Accept' (if needed)
+        header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+        # HTTP header 'Content-Type'
+        header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
+        header_params[:'x-amzn-idempotency-token'] = x_amzn_idempotency_token
+
+        # form parameters
+        form_params = opts[:form_params] || {}
+
+        # http body (model)
+        post_body = opts[:body] || @api_client.object_to_http_body(body) 
+
+        return_type = opts[:return_type] || 'AmazonSpClients::ApiResponse' 
+
+        auth_names = opts[:auth_names] || []
+        data = @api_client.call_api(:POST, local_var_path,
+          :header_params => header_params,
+          :query_params => query_params,
+          :form_params => form_params,
+          :body => post_body,
+          :auth_names => auth_names,
+          :return_type => return_type)
+
+        if @api_client.config.debugging
+          @api_client.config.logger.debug "API called: FbaInventoryApi#add_inventory\nData: #{data.inspect}"
+        end
+        return data
+      end
+      # Requests that Amazon create product-details in the Sandbox Inventory in the sandbox environment. This is a sandbox-only operation and must be directed to a sandbox endpoint. Refer to [Selling Partner API sandbox](https://developer-docs.amazon.com/sp-api/docs/the-selling-partner-api-sandbox) for more information.
+      # @param body CreateInventoryItem Request Body Parameter.
+      # @param [Hash] opts the optional parameters
+      # @return [CreateInventoryItemResponse]
+      def create_inventory_item(body, opts = {})
+        data = create_inventory_item_with_http_info(body, opts)
+        return data
+      end
+
+      # Requests that Amazon create product-details in the Sandbox Inventory in the sandbox environment. This is a sandbox-only operation and must be directed to a sandbox endpoint. Refer to [Selling Partner API sandbox](https://developer-docs.amazon.com/sp-api/docs/the-selling-partner-api-sandbox) for more information.
+      # @param body CreateInventoryItem Request Body Parameter.
+      # @param [Hash] opts the optional parameters
+      # @return [Array<(CreateInventoryItemResponse)>] CreateInventoryItemResponse data, response status code and response headers
+      def create_inventory_item_with_http_info(body, opts = {})
+        if @api_client.config.debugging
+          @api_client.config.logger.debug 'Calling API: FbaInventoryApi.create_inventory_item ...'
+        end
+        # verify the required parameter 'body' is set
+        if @api_client.config.client_side_validation && body.nil?
+          fail ArgumentError, "Missing the required parameter 'body' when calling FbaInventoryApi.create_inventory_item"
+        end
+        # resource path
+        local_var_path = '/fba/inventory/v1/items'
+
+        # query parameters
+        query_params = opts[:query_params] || {}
+
+        # header parameters
+        header_params = opts[:header_params] || {}
+        # HTTP header 'Accept' (if needed)
+        header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+        # HTTP header 'Content-Type'
+        header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
+
+        # form parameters
+        form_params = opts[:form_params] || {}
+
+        # http body (model)
+        post_body = opts[:body] || @api_client.object_to_http_body(body) 
+
+        return_type = opts[:return_type] || 'AmazonSpClients::ApiResponse' 
+
+        auth_names = opts[:auth_names] || []
+        data = @api_client.call_api(:POST, local_var_path,
+          :header_params => header_params,
+          :query_params => query_params,
+          :form_params => form_params,
+          :body => post_body,
+          :auth_names => auth_names,
+          :return_type => return_type)
+
+        if @api_client.config.debugging
+          @api_client.config.logger.debug "API called: FbaInventoryApi#create_inventory_item\nData: #{data.inspect}"
+        end
+        return data
+      end
+      # Requests that Amazon Deletes an item from the Sandbox Inventory in the sandbox environment. This is a sandbox-only operation and must be directed to a sandbox endpoint. Refer to [Selling Partner API sandbox](https://developer-docs.amazon.com/sp-api/docs/the-selling-partner-api-sandbox) for more information.
+      # @param seller_sku A single seller SKU used for querying the specified seller SKU inventory summaries.
+      # @param marketplace_id The marketplace ID for the marketplace for which the sellerSku is to be deleted.
+      # @param [Hash] opts the optional parameters
+      # @return [DeleteInventoryItemResponse]
+      def delete_inventory_item(seller_sku, marketplace_id, opts = {})
+        data = delete_inventory_item_with_http_info(seller_sku, marketplace_id, opts)
+        return data
+      end
+
+      # Requests that Amazon Deletes an item from the Sandbox Inventory in the sandbox environment. This is a sandbox-only operation and must be directed to a sandbox endpoint. Refer to [Selling Partner API sandbox](https://developer-docs.amazon.com/sp-api/docs/the-selling-partner-api-sandbox) for more information.
+      # @param seller_sku A single seller SKU used for querying the specified seller SKU inventory summaries.
+      # @param marketplace_id The marketplace ID for the marketplace for which the sellerSku is to be deleted.
+      # @param [Hash] opts the optional parameters
+      # @return [Array<(DeleteInventoryItemResponse)>] DeleteInventoryItemResponse data, response status code and response headers
+      def delete_inventory_item_with_http_info(seller_sku, marketplace_id, opts = {})
+        if @api_client.config.debugging
+          @api_client.config.logger.debug 'Calling API: FbaInventoryApi.delete_inventory_item ...'
+        end
+        # verify the required parameter 'seller_sku' is set
+        if @api_client.config.client_side_validation && seller_sku.nil?
+          fail ArgumentError, "Missing the required parameter 'seller_sku' when calling FbaInventoryApi.delete_inventory_item"
+        end
+        # verify the required parameter 'marketplace_id' is set
+        if @api_client.config.client_side_validation && marketplace_id.nil?
+          fail ArgumentError, "Missing the required parameter 'marketplace_id' when calling FbaInventoryApi.delete_inventory_item"
+        end
+        # resource path
+        local_var_path = '/fba/inventory/v1/items/{sellerSku}'.sub('{' + 'sellerSku' + '}', seller_sku.to_s)
+
+        # query parameters
+        query_params = opts[:query_params] || {}
+        query_params[:'marketplaceId'] = marketplace_id
+
+        # header parameters
+        header_params = opts[:header_params] || {}
+        # HTTP header 'Accept' (if needed)
+        header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+
+        # form parameters
+        form_params = opts[:form_params] || {}
+
+        # http body (model)
+        post_body = opts[:body] 
+
+        return_type = opts[:return_type] || 'AmazonSpClients::ApiResponse' 
+
+        auth_names = opts[:auth_names] || []
+        data = @api_client.call_api(:DELETE, local_var_path,
+          :header_params => header_params,
+          :query_params => query_params,
+          :form_params => form_params,
+          :body => post_body,
+          :auth_names => auth_names,
+          :return_type => return_type)
+
+        if @api_client.config.debugging
+          @api_client.config.logger.debug "API called: FbaInventoryApi#delete_inventory_item\nData: #{data.inspect}"
+        end
+        return data
+      end
+      # Returns a list of inventory summaries. The summaries returned depend on the presence or absence of the startDateTime, sellerSkus and sellerSku parameters:  - All inventory summaries with available details are returned when the startDateTime, sellerSkus and sellerSku parameters are omitted. - When startDateTime is provided, the operation returns inventory summaries that have had changes after the date and time specified. The sellerSkus and sellerSku parameters are ignored. Important: To avoid errors, use both startDateTime and nextToken to get the next page of inventory summaries that have changed after the date and time specified. - When the sellerSkus parameter is provided, the operation returns inventory summaries for only the specified sellerSkus. The sellerSku parameter is ignored. - When the sellerSku parameter is provided, the operation returns inventory summaries for only the specified sellerSku.  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).  Usage Plan:  | Rate (requests per second) | Burst | | ---- | ---- | | 2 | 2 |  The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation, when available. The table above indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may see higher rate and burst values than those shown here. For more information, see [Usage Plans and Rate Limits in the Selling Partner API](https://developer-docs.amazon.com/sp-api/docs/usage-plans-and-rate-limits).
+      # @param granularity_type The granularity type for the inventory aggregation level.
+      # @param granularity_id The granularity ID for the inventory aggregation level.
+      # @param marketplace_ids The marketplace ID for the marketplace for which to return inventory summaries.
+      # @param [Hash] opts the optional parameters
+      # @option opts [BOOLEAN] :details true to return inventory summaries with additional summarized inventory details and quantities. Otherwise, returns inventory summaries only (default value). (default to false)
+      # @option opts [DateTime] :start_date_time A start date and time in ISO8601 format. If specified, all inventory summaries that have changed since then are returned. You must specify a date and time that is no earlier than 18 months prior to the date and time when you call the API. Note: Changes in inboundWorkingQuantity, inboundShippedQuantity and inboundReceivingQuantity are not detected.
+      # @option opts [Array<String>] :seller_skus A list of seller SKUs for which to return inventory summaries. You may specify up to 50 SKUs.
+      # @option opts [String] :seller_sku A single seller SKU used for querying the specified seller SKU inventory summaries.
+      # @option opts [String] :next_token String token returned in the response of your previous request. The string token will expire 30 seconds after being created.
+      # @return [GetInventorySummariesResponse]
+      def get_inventory_summaries(granularity_type, granularity_id, marketplace_ids, opts = {})
+        data = get_inventory_summaries_with_http_info(granularity_type, granularity_id, marketplace_ids, opts)
+        return data
+      end
+
+      # Returns a list of inventory summaries. The summaries returned depend on the presence or absence of the startDateTime, sellerSkus and sellerSku parameters:  - All inventory summaries with available details are returned when the startDateTime, sellerSkus and sellerSku parameters are omitted. - When startDateTime is provided, the operation returns inventory summaries that have had changes after the date and time specified. The sellerSkus and sellerSku parameters are ignored. Important: To avoid errors, use both startDateTime and nextToken to get the next page of inventory summaries that have changed after the date and time specified. - When the sellerSkus parameter is provided, the operation returns inventory summaries for only the specified sellerSkus. The sellerSku parameter is ignored. - When the sellerSku parameter is provided, the operation returns inventory summaries for only the specified sellerSku.  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).  Usage Plan:  | Rate (requests per second) | Burst | | ---- | ---- | | 2 | 2 |  The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation, when available. The table above indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may see higher rate and burst values than those shown here. For more information, see [Usage Plans and Rate Limits in the Selling Partner API](https://developer-docs.amazon.com/sp-api/docs/usage-plans-and-rate-limits).
+      # @param granularity_type The granularity type for the inventory aggregation level.
+      # @param granularity_id The granularity ID for the inventory aggregation level.
+      # @param marketplace_ids The marketplace ID for the marketplace for which to return inventory summaries.
+      # @param [Hash] opts the optional parameters
+      # @option opts [BOOLEAN] :details true to return inventory summaries with additional summarized inventory details and quantities. Otherwise, returns inventory summaries only (default value).
+      # @option opts [DateTime] :start_date_time A start date and time in ISO8601 format. If specified, all inventory summaries that have changed since then are returned. You must specify a date and time that is no earlier than 18 months prior to the date and time when you call the API. Note: Changes in inboundWorkingQuantity, inboundShippedQuantity and inboundReceivingQuantity are not detected.
+      # @option opts [Array<String>] :seller_skus A list of seller SKUs for which to return inventory summaries. You may specify up to 50 SKUs.
+      # @option opts [String] :seller_sku A single seller SKU used for querying the specified seller SKU inventory summaries.
+      # @option opts [String] :next_token String token returned in the response of your previous request. The string token will expire 30 seconds after being created.
+      # @return [Array<(GetInventorySummariesResponse)>] GetInventorySummariesResponse data, response status code and response headers
+      def get_inventory_summaries_with_http_info(granularity_type, granularity_id, marketplace_ids, opts = {})
+        if @api_client.config.debugging
+          @api_client.config.logger.debug 'Calling API: FbaInventoryApi.get_inventory_summaries ...'
+        end
+        # verify the required parameter 'granularity_type' is set
+        if @api_client.config.client_side_validation && granularity_type.nil?
+          fail ArgumentError, "Missing the required parameter 'granularity_type' when calling FbaInventoryApi.get_inventory_summaries"
+        end
+        # verify enum value
+        if @api_client.config.client_side_validation && !['Marketplace'].include?(granularity_type)
+          fail ArgumentError, "invalid value for 'granularity_type', must be one of Marketplace"
+        end
+        # verify the required parameter 'granularity_id' is set
+        if @api_client.config.client_side_validation && granularity_id.nil?
+          fail ArgumentError, "Missing the required parameter 'granularity_id' when calling FbaInventoryApi.get_inventory_summaries"
+        end
+        # verify the required parameter 'marketplace_ids' is set
+        if @api_client.config.client_side_validation && marketplace_ids.nil?
+          fail ArgumentError, "Missing the required parameter 'marketplace_ids' when calling FbaInventoryApi.get_inventory_summaries"
+        end
+        # resource path
+        local_var_path = '/fba/inventory/v1/summaries'
+
+        # query parameters
+        query_params = opts[:query_params] || {}
+        query_params[:'granularityType'] = granularity_type
+        query_params[:'granularityId'] = granularity_id
+        query_params[:'marketplaceIds'] = @api_client.build_collection_param(marketplace_ids, :csv)
+        query_params[:'details'] = opts[:'details'] if !opts[:'details'].nil?
+        query_params[:'startDateTime'] = opts[:'start_date_time'] if !opts[:'start_date_time'].nil?
+        query_params[:'sellerSkus'] = @api_client.build_collection_param(opts[:'seller_skus'], :csv) if !opts[:'seller_skus'].nil?
+        query_params[:'sellerSku'] = opts[:'seller_sku'] if !opts[:'seller_sku'].nil?
+        query_params[:'nextToken'] = opts[:'next_token'] if !opts[:'next_token'].nil?
+
+        # header parameters
+        header_params = opts[:header_params] || {}
+        # HTTP header 'Accept' (if needed)
+        header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+
+        # form parameters
+        form_params = opts[:form_params] || {}
+
+        # http body (model)
+        post_body = opts[:body] 
+
+        return_type = opts[:return_type] || 'AmazonSpClients::ApiResponse' 
+
+        auth_names = opts[:auth_names] || []
+        data = @api_client.call_api(:GET, local_var_path,
+          :header_params => header_params,
+          :query_params => query_params,
+          :form_params => form_params,
+          :body => post_body,
+          :auth_names => auth_names,
+          :return_type => return_type)
+
+        if @api_client.config.debugging
+          @api_client.config.logger.debug "API called: FbaInventoryApi#get_inventory_summaries\nData: #{data.inspect}"
+        end
+        return data
+      end
+    end
+  end
+end

data/vendor/fba_inventory/lib/sp_fba_inventory.rb

@@ -0,0 +1,12 @@
+=begin
+#Selling Partner API for FBA Inventory
+
+#The Selling Partner API for FBA Inventory lets you programmatically retrieve information about inventory in Amazon's fulfillment network.
+
+OpenAPI spec version: v1
+
+Generated by: lib/generator (bundle exec rake generate)
+=end
+
+# APIs
+require_relative './sp_fba_inventory/api/fba_inventory_api'