sp_api_clients 2.0.0

data/lib/amazon_sp_clients/v2/apis/fba_inventory.rb

@@ -0,0 +1,80 @@
+# frozen_string_literal: true
+
+# Generated by lib/generator (bundle exec rake generate). Do not edit.
+
+require 'amazon_sp_clients/v2/api'
+
+module AmazonSpClients
+  module V2
+    # 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
+    class FbaInventory < Api
+      # 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 [Hash] List of items to add to Sandbox inventory. (AddInventoryRequest)
+      # @param x_amzn_idempotency_token [String] A unique token/requestId provided with each call to ensure idempotency.
+      # @param rdt [Array<RDT::Resource>, nil] send a restricted data token for these resources
+      # @return [AmazonSpClients::ApiResponse]
+      def add_inventory(body, x_amzn_idempotency_token, rdt: nil)
+        headers = {
+          'x-amzn-idempotency-token' => x_amzn_idempotency_token
+        }
+
+        request(:post, '/fba/inventory/v1/items/inventory', headers: headers, body: body, rdt: rdt)
+      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 [Hash] CreateInventoryItem Request Body Parameter. (CreateInventoryItemRequest)
+      # @param rdt [Array<RDT::Resource>, nil] send a restricted data token for these resources
+      # @return [AmazonSpClients::ApiResponse]
+      def create_inventory_item(body, rdt: nil)
+        request(:post, '/fba/inventory/v1/items', body: body, rdt: rdt)
+      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 [String] A single seller SKU used for querying the specified seller SKU inventory summaries.
+      # @param marketplace_id [String] The marketplace ID for the marketplace for which the sellerSku is to be deleted.
+      # @param rdt [Array<RDT::Resource>, nil] send a restricted data token for these resources
+      # @return [AmazonSpClients::ApiResponse]
+      def delete_inventory_item(seller_sku, marketplace_id, rdt: nil)
+        query = {
+          'marketplaceId' => marketplace_id
+        }
+
+        request(:delete, "/fba/inventory/v1/items/#{encode(seller_sku)}", query: query, rdt: rdt)
+      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 [String] The granularity type for the inventory aggregation level.
+      # @param granularity_id [String] The granularity ID for the inventory aggregation level.
+      # @param marketplace_ids [Array<String>] The marketplace ID for the marketplace for which to return inventory summaries.
+      # @param details [Boolean, nil] true to return inventory summaries with additional summarized inventory details and quantities. Otherwise, returns inventory summaries only (default value).
+      # @param start_date_time [String, nil] 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.
+      # @param seller_skus [Array<String>, nil] A list of seller SKUs for which to return inventory summaries. You may specify up to 50 SKUs.
+      # @param seller_sku [String, nil] A single seller SKU used for querying the specified seller SKU inventory summaries.
+      # @param next_token [String, nil] String token returned in the response of your previous request. The string token will expire 30 seconds after being created.
+      # @param rdt [Array<RDT::Resource>, nil] send a restricted data token for these resources
+      # @return [AmazonSpClients::ApiResponse]
+      def get_inventory_summaries(granularity_type, granularity_id, marketplace_ids, details: nil, start_date_time: nil, seller_skus: nil, seller_sku: nil, next_token: nil, rdt: nil)
+        query = {
+          'details' => details,
+          'granularityType' => granularity_type,
+          'granularityId' => granularity_id,
+          'startDateTime' => start_date_time,
+          'sellerSkus' => csv(seller_skus),
+          'sellerSku' => seller_sku,
+          'nextToken' => next_token,
+          'marketplaceIds' => csv(marketplace_ids)
+        }
+
+        request(:get, '/fba/inventory/v1/summaries', query: query, rdt: rdt)
+      end
+    end
+  end
+end

data/lib/amazon_sp_clients/v2/apis/feeds_2021.rb

@@ -0,0 +1,86 @@
+# frozen_string_literal: true
+
+# Generated by lib/generator (bundle exec rake generate). Do not edit.
+
+require 'amazon_sp_clients/v2/api'
+
+module AmazonSpClients
+  module V2
+    # Selling Partner API for Feeds
+    #
+    # The Selling Partner API for Feeds lets you upload data to Amazon on behalf of a selling partner.
+    #
+    # OpenAPI spec version: 2021-06-30
+    class Feeds2021 < Api
+      # Cancels the feed that you specify. Only feeds with `processingStatus=IN_QUEUE` can be cancelled. Cancelled feeds are returned in subsequent calls to the [`getFeed`](https://developer-docs.amazon.com/sp-api/docs/feeds-api-v2021-06-30-reference#getfeed) and [`getFeeds`](https://developer-docs.amazon.com/sp-api/docs/feeds-api-v2021-06-30-reference#getfeeds) operations. **Usage Plan:** | Rate (requests per second) | Burst | | ---- | ---- | | 2 | 15 | The `x-amzn-RateLimit-Limit` response header returns the usage plan rate limits that were applied to the requested operation, when available. The preceding table indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may have higher rate and burst values than those shown here. For more information, refer to [Usage Plans and Rate Limits in the Selling Partner API](https://developer-docs.amazon.com/sp-api/docs/usage-plans-and-rate-limits-in-the-sp-api).
+      #
+      # @param feed_id [String] The identifier for the feed. This identifier is unique only in combination with a seller ID.
+      # @param rdt [Array<RDT::Resource>, nil] send a restricted data token for these resources
+      # @return [AmazonSpClients::ApiResponse]
+      def cancel_feed(feed_id, rdt: nil)
+        request(:delete, "/feeds/2021-06-30/feeds/#{encode(feed_id)}", rdt: rdt)
+      end
+
+      # Creates a feed. Upload the contents of the feed document before calling this operation. **Usage Plan:** | Rate (requests per second) | Burst | | ---- | ---- | | 0.0083 | 15 | The `x-amzn-RateLimit-Limit` response header returns the usage plan rate limits that were applied to the requested operation, when available. The preceding table indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may have higher rate and burst values than those shown here. For more information, refer to [Usage Plans and Rate Limits in the Selling Partner API](https://developer-docs.amazon.com/sp-api/docs/usage-plans-and-rate-limits-in-the-sp-api). The rate limit for the [`JSON_LISTINGS_FEED`](https://developer-docs.amazon.com/sp-api/docs/listings-feed-type-values#listings-feed) feed type differs from the rate limit for the [`createFeed`](https://developer-docs.amazon.com/sp-api/docs/feeds-api-v2021-06-30-reference#post-feeds2021-06-30feeds) operation. For more information, refer to the [Building Listings Management Workflows Guide](https://developer-docs.amazon.com/sp-api/docs/building-listings-management-workflows-guide#should-i-submit-in-bulk-using-the-json_listings_feed-or-individually-with-the-listings-items-api).
+      #
+      # @param body [Hash] Information required to create the feed. (CreateFeedSpecification)
+      # @param rdt [Array<RDT::Resource>, nil] send a restricted data token for these resources
+      # @return [AmazonSpClients::ApiResponse]
+      def create_feed(body, rdt: nil)
+        request(:post, '/feeds/2021-06-30/feeds', body: body, rdt: rdt)
+      end
+
+      # Creates a feed document for the feed type that you specify. This operation returns a presigned URL for uploading the feed document contents. It also returns a `feedDocumentId` value that you can pass in with a subsequent call to the [`createFeed`](https://developer-docs.amazon.com/sp-api/docs/feeds-api-v2021-06-30-reference#createfeed) operation. **Usage Plan:** | Rate (requests per second) | Burst | | ---- | ---- | | 0.5 | 15 | The `x-amzn-RateLimit-Limit` response header returns the usage plan rate limits that were applied to the requested operation, when available. The preceding table indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may have higher rate and burst values than those shown here. For more information, refer to [Usage Plans and Rate Limits in the Selling Partner API](https://developer-docs.amazon.com/sp-api/docs/usage-plans-and-rate-limits-in-the-sp-api).
+      #
+      # @param body [Hash] Specifies the content type for the createFeedDocument operation. (CreateFeedDocumentSpecification)
+      # @param rdt [Array<RDT::Resource>, nil] send a restricted data token for these resources
+      # @return [AmazonSpClients::ApiResponse]
+      def create_feed_document(body, rdt: nil)
+        request(:post, '/feeds/2021-06-30/documents', body: body, rdt: rdt)
+      end
+
+      # Returns feed details (including the `resultDocumentId`, if available) for the feed that you specify. **Usage Plan:** | Rate (requests per second) | Burst | | ---- | ---- | | 2 | 15 | The `x-amzn-RateLimit-Limit` response header returns the usage plan rate limits that were applied to the requested operation, when available. The preceding table indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may have higher rate and burst values than those shown here. For more information, refer to [Usage Plans and Rate Limits in the Selling Partner API](https://developer-docs.amazon.com/sp-api/docs/usage-plans-and-rate-limits-in-the-sp-api).
+      #
+      # @param feed_id [String] The identifier for the feed. This identifier is unique only in combination with a seller ID.
+      # @param rdt [Array<RDT::Resource>, nil] send a restricted data token for these resources
+      # @return [AmazonSpClients::ApiResponse]
+      def get_feed(feed_id, rdt: nil)
+        request(:get, "/feeds/2021-06-30/feeds/#{encode(feed_id)}", rdt: rdt)
+      end
+
+      # Returns the information required for retrieving a feed document's contents. **Usage Plan:** | Rate (requests per second) | Burst | | ---- | ---- | | 0.0222 | 10 | The `x-amzn-RateLimit-Limit` response header returns the usage plan rate limits that were applied to the requested operation, when available. The preceding table indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may have higher rate and burst values than those shown here. For more information, refer to [Usage Plans and Rate Limits in the Selling Partner API](https://developer-docs.amazon.com/sp-api/docs/usage-plans-and-rate-limits-in-the-sp-api).
+      #
+      # @param feed_document_id [String] The identifier of the feed document.
+      # @param rdt [Array<RDT::Resource>, nil] send a restricted data token for these resources
+      # @return [AmazonSpClients::ApiResponse]
+      def get_feed_document(feed_document_id, rdt: nil)
+        request(:get, "/feeds/2021-06-30/documents/#{encode(feed_document_id)}", rdt: rdt)
+      end
+
+      # Returns feed details for the feeds that match the filters that you specify. **Usage Plan:** | Rate (requests per second) | Burst | | ---- | ---- | | 0.0222 | 10 | The `x-amzn-RateLimit-Limit` response header returns the usage plan rate limits that were applied to the requested operation, when available. The preceding table indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may have higher rate and burst values than those shown here. For more information, refer to [Usage Plans and Rate Limits in the Selling Partner API](https://developer-docs.amazon.com/sp-api/docs/usage-plans-and-rate-limits-in-the-sp-api).
+      #
+      # @param feed_types [Array<String>, nil] A list of feed types used to filter feeds. When feedTypes is provided, the other filter parameters (processingStatuses, marketplaceIds, createdSince, createdUntil) and pageSize may also be provided. Either feedTypes or nextToken is required.
+      # @param marketplace_ids [Array<String>, nil] A list of marketplace identifiers used to filter feeds. The feeds returned will match at least one of the marketplaces that you specify.
+      # @param page_size [Integer, nil] The maximum number of feeds to return in a single call.
+      # @param processing_statuses [Array<String>, nil] A list of processing statuses used to filter feeds.
+      # @param created_since [String, nil] The earliest feed creation date and time for feeds included in the response, in ISO 8601 format. The default is 90 days ago. Feeds are retained for a maximum of 90 days.
+      # @param created_until [String, nil] The latest feed creation date and time for feeds included in the response, in ISO 8601 format. The default is now.
+      # @param next_token [String, nil] A string token returned in the response to your previous request. nextToken is returned when the number of results exceeds the specified pageSize value. To get the next page of results, call the getFeeds operation and include this token as the only parameter. Specifying nextToken with any other parameters will cause the request to fail.
+      # @param rdt [Array<RDT::Resource>, nil] send a restricted data token for these resources
+      # @return [AmazonSpClients::ApiResponse]
+      def get_feeds(feed_types: nil, marketplace_ids: nil, page_size: nil, processing_statuses: nil, created_since: nil, created_until: nil, next_token: nil, rdt: nil)
+        query = {
+          'feedTypes' => csv(feed_types),
+          'marketplaceIds' => csv(marketplace_ids),
+          'pageSize' => page_size,
+          'processingStatuses' => csv(processing_statuses),
+          'createdSince' => created_since,
+          'createdUntil' => created_until,
+          'nextToken' => next_token
+        }
+
+        request(:get, '/feeds/2021-06-30/feeds', query: query, rdt: rdt)
+      end
+    end
+  end
+end

data/lib/amazon_sp_clients/v2/apis/fulfillment_outbound_2020.rb

@@ -0,0 +1,184 @@
+# frozen_string_literal: true
+
+# Generated by lib/generator (bundle exec rake generate). Do not edit.
+
+require 'amazon_sp_clients/v2/api'
+
+module AmazonSpClients
+  module V2
+    # Selling Partner APIs for Fulfillment Outbound
+    #
+    # The Selling Partner API for Fulfillment Outbound lets you create applications that help a seller fulfill Multi-Channel Fulfillment orders using their inventory in Amazon's fulfillment network. You can get information on both potential and existing fulfillment orders.
+    #
+    # OpenAPI spec version: 2020-07-01
+    class FulfillmentOutbound2020 < Api
+      # Requests that Amazon stop attempting to fulfill the fulfillment order indicated by the specified order identifier. **Usage Plan:** | Rate (requests per second) | Burst | | ---- | ---- | | 2 | 30 | 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 have higher rate and burst values than those shown here. For more information, refer to [Usage Plans and Rate Limits in the Selling Partner API](https://developer-docs.amazon.com/sp-api/docs/usage-plans-and-rate-limits-in-the-sp-api).
+      #
+      # @param seller_fulfillment_order_id [String] The identifier assigned to the item by the seller when the fulfillment order was created.
+      # @param rdt [Array<RDT::Resource>, nil] send a restricted data token for these resources
+      # @return [AmazonSpClients::ApiResponse]
+      def cancel_fulfillment_order(seller_fulfillment_order_id, rdt: nil)
+        request(:put, "/fba/outbound/2020-07-01/fulfillmentOrders/#{encode(seller_fulfillment_order_id)}/cancel", rdt: rdt)
+      end
+
+      # Requests that Amazon ship items from the seller's inventory in Amazon's fulfillment network to a destination address. **Usage Plan:** | Rate (requests per second) | Burst | | ---- | ---- | | 2 | 30 | 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 have higher rate and burst values than those shown here. For more information, refer to [Usage Plans and Rate Limits in the Selling Partner API](https://developer-docs.amazon.com/sp-api/docs/usage-plans-and-rate-limits-in-the-sp-api)
+      #
+      # @param body [Hash] CreateFulfillmentOrderRequest parameter (CreateFulfillmentOrderRequest)
+      # @param rdt [Array<RDT::Resource>, nil] send a restricted data token for these resources
+      # @return [AmazonSpClients::ApiResponse]
+      def create_fulfillment_order(body, rdt: nil)
+        request(:post, '/fba/outbound/2020-07-01/fulfillmentOrders', body: body, rdt: rdt)
+      end
+
+      # Creates a fulfillment return. **Usage Plan:** | Rate (requests per second) | Burst | | ---- | ---- | | 2 | 30 | 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 have higher rate and burst values than those shown here. For more information, refer to [Usage Plans and Rate Limits in the Selling Partner API](https://developer-docs.amazon.com/sp-api/docs/usage-plans-and-rate-limits-in-the-sp-api).
+      #
+      # @param body [Hash] CreateFulfillmentReturnRequest parameter (CreateFulfillmentReturnRequest)
+      # @param seller_fulfillment_order_id [String] An identifier assigned by the seller to the fulfillment order at the time it was created. The seller uses their own records to find the correct `SellerFulfillmentOrderId` value based on the buyer's request to return items.
+      # @param rdt [Array<RDT::Resource>, nil] send a restricted data token for these resources
+      # @return [AmazonSpClients::ApiResponse]
+      def create_fulfillment_return(body, seller_fulfillment_order_id, rdt: nil)
+        request(:put, "/fba/outbound/2020-07-01/fulfillmentOrders/#{encode(seller_fulfillment_order_id)}/return", body: body, rdt: rdt)
+      end
+
+      # Returns delivery options that include an estimated delivery date and offer expiration, based on criteria that you specify. **Usage Plan:** | Rate (requests per second) | Burst | | ---- | ---- | | 5 | 30 | 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 have higher rate and burst values than those shown here. For more information, refer to [Usage Plans and Rate Limits in the Selling Partner API](https://developer-docs.amazon.com/sp-api/docs/usage-plans-and-rate-limits-in-the-sp-api).
+      #
+      # @param body [Hash] GetDeliveryOffersRequest parameter (GetDeliveryOffersRequest)
+      # @param rdt [Array<RDT::Resource>, nil] send a restricted data token for these resources
+      # @return [AmazonSpClients::ApiResponse]
+      def delivery_offers(body, rdt: nil)
+        request(:post, '/fba/outbound/2020-07-01/deliveryOffers', body: body, rdt: rdt)
+      end
+
+      # Returns a list of inventory items that are eligible for the fulfillment feature you specify. **Usage Plan:** | Rate (requests per second) | Burst | | ---- | ---- | | 2 | 30 | 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 have higher rate and burst values than those shown here. For more information, refer to [Usage Plans and Rate Limits in the Selling Partner API](https://developer-docs.amazon.com/sp-api/docs/usage-plans-and-rate-limits-in-the-sp-api)..
+      #
+      # @param marketplace_id [String] The marketplace for which to return a list of the inventory that is eligible for the specified feature.
+      # @param feature_name [String] The name of the feature for which to return a list of eligible inventory.
+      # @param next_token [String, nil] A string token returned in the response to your previous request that is used to return the next response page. A value of null will return the first page.
+      # @param query_start_date [String, nil] A date that you can use to select inventory that has been updated since a specified date. An update is defined as any change in feature-enabled inventory availability. The date must be in the format yyyy-MM-ddTHH:mm:ss.sssZ
+      # @param rdt [Array<RDT::Resource>, nil] send a restricted data token for these resources
+      # @return [AmazonSpClients::ApiResponse]
+      def get_feature_inventory(marketplace_id, feature_name, next_token: nil, query_start_date: nil, rdt: nil)
+        query = {
+          'marketplaceId' => marketplace_id,
+          'nextToken' => next_token,
+          'queryStartDate' => query_start_date
+        }
+
+        request(:get, "/fba/outbound/2020-07-01/features/inventory/#{encode(feature_name)}", query: query, rdt: rdt)
+      end
+
+      # Returns the number of items with the sellerSKU you specify that can have orders fulfilled using the specified feature. Note that if the sellerSKU isn't eligible, the response will contain an empty skuInfo object. The parameters for this operation may contain special characters that require URL encoding. 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 | 30 | 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 have higher rate and burst values than those shown here. For more information, refer to [Usage Plans and Rate Limits in the Selling Partner API](https://developer-docs.amazon.com/sp-api/docs/usage-plans-and-rate-limits-in-the-sp-api).
+      #
+      # @param marketplace_id [String] The marketplace for which to return the count.
+      # @param feature_name [String] The name of the feature.
+      # @param seller_sku [String] 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.
+      # @param rdt [Array<RDT::Resource>, nil] send a restricted data token for these resources
+      # @return [AmazonSpClients::ApiResponse]
+      def get_feature_sku(marketplace_id, feature_name, seller_sku, rdt: nil)
+        query = {
+          'marketplaceId' => marketplace_id
+        }
+
+        request(:get, "/fba/outbound/2020-07-01/features/inventory/#{encode(feature_name)}/#{encode(seller_sku)}", query: query, rdt: rdt)
+      end
+
+      # Returns a list of features available for Multi-Channel Fulfillment orders in the marketplace you specify, and whether the seller for which you made the call is enrolled for each feature. **Usage Plan:** | Rate (requests per second) | Burst | | ---- | ---- | | 2 | 30 | 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 have higher rate and burst values than those shown here. For more information, refer to [Usage Plans and Rate Limits in the Selling Partner API](https://developer-docs.amazon.com/sp-api/docs/usage-plans-and-rate-limits-in-the-sp-api).
+      #
+      # @param marketplace_id [String] The marketplace for which to return the list of features.
+      # @param rdt [Array<RDT::Resource>, nil] send a restricted data token for these resources
+      # @return [AmazonSpClients::ApiResponse]
+      def get_features(marketplace_id, rdt: nil)
+        query = {
+          'marketplaceId' => marketplace_id
+        }
+
+        request(:get, '/fba/outbound/2020-07-01/features', query: query, rdt: rdt)
+      end
+
+      # Returns the fulfillment order indicated by the specified order identifier. **Usage Plan:** | Rate (requests per second) | Burst | | ---- | ---- | | 2 | 30 | 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 have higher rate and burst values than those shown here. For more information, refer to [Usage Plans and Rate Limits in the Selling Partner API](https://developer-docs.amazon.com/sp-api/docs/usage-plans-and-rate-limits-in-the-sp-api).
+      #
+      # @param seller_fulfillment_order_id [String] The identifier assigned to the item by the seller when the fulfillment order was created.
+      # @param rdt [Array<RDT::Resource>, nil] send a restricted data token for these resources
+      # @return [AmazonSpClients::ApiResponse]
+      def get_fulfillment_order(seller_fulfillment_order_id, rdt: nil)
+        request(:get, "/fba/outbound/2020-07-01/fulfillmentOrders/#{encode(seller_fulfillment_order_id)}", rdt: rdt)
+      end
+
+      # Returns a list of fulfillment order previews based on shipping criteria that you specify. **Usage Plan:** | Rate (requests per second) | Burst | | ---- | ---- | | 2 | 30 | 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 have higher rate and burst values than those shown here. For more information, refer to [Usage Plans and Rate Limits in the Selling Partner API](https://developer-docs.amazon.com/sp-api/docs/usage-plans-and-rate-limits-in-the-sp-api).
+      #
+      # @param body [Hash] GetFulfillmentPreviewRequest parameter (GetFulfillmentPreviewRequest)
+      # @param rdt [Array<RDT::Resource>, nil] send a restricted data token for these resources
+      # @return [AmazonSpClients::ApiResponse]
+      def get_fulfillment_preview(body, rdt: nil)
+        request(:post, '/fba/outbound/2020-07-01/fulfillmentOrders/preview', body: body, rdt: rdt)
+      end
+
+      # Returns delivery tracking information for a package in an outbound shipment for a Multi-Channel Fulfillment order. **Usage Plan:** | Rate (requests per second) | Burst | | ---- | ---- | | 2 | 30 | 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 have higher rate and burst values than those shown here. For more information, refer to [Usage Plans and Rate Limits in the Selling Partner API](https://developer-docs.amazon.com/sp-api/docs/usage-plans-and-rate-limits-in-the-sp-api).
+      #
+      # @param package_number [Integer] The unencrypted package identifier returned by the `getFulfillmentOrder` operation.
+      # @param rdt [Array<RDT::Resource>, nil] send a restricted data token for these resources
+      # @return [AmazonSpClients::ApiResponse]
+      def get_package_tracking_details(package_number, rdt: nil)
+        query = {
+          'packageNumber' => package_number
+        }
+
+        request(:get, '/fba/outbound/2020-07-01/tracking', query: query, rdt: rdt)
+      end
+
+      # Returns a list of fulfillment orders fulfilled after (or at) a specified date-time, or indicated by the next token parameter. **Usage Plan:** | Rate (requests per second) | Burst | | ---- | ---- | | 2 | 30 | 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 have higher rate and burst values than those shown here. For more information, refer to [Usage Plans and Rate Limits in the Selling Partner API](https://developer-docs.amazon.com/sp-api/docs/usage-plans-and-rate-limits-in-the-sp-api)
+      #
+      # @param query_start_date [String, nil] A date used to select fulfillment orders that were last updated after (or at) a specified time. An update is defined as any change in fulfillment order status, including the creation of a new fulfillment order.
+      # @param next_token [String, nil] A string token returned in the response to your previous request.
+      # @param rdt [Array<RDT::Resource>, nil] send a restricted data token for these resources
+      # @return [AmazonSpClients::ApiResponse]
+      def list_all_fulfillment_orders(query_start_date: nil, next_token: nil, rdt: nil)
+        query = {
+          'queryStartDate' => query_start_date,
+          'nextToken' => next_token
+        }
+
+        request(:get, '/fba/outbound/2020-07-01/fulfillmentOrders', query: query, rdt: rdt)
+      end
+
+      # Returns a list of return reason codes for a seller SKU in a given marketplace. The parameters for this operation may contain special characters that require URL encoding. 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 | 30 | 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 have higher rate and burst values than those shown here. For more information, refer to [Usage Plans and Rate Limits in the Selling Partner API](https://developer-docs.amazon.com/sp-api/docs/usage-plans-and-rate-limits-in-the-sp-api).
+      #
+      # @param seller_sku [String] The seller SKU for which return reason codes are required.
+      # @param marketplace_id [String, nil] The marketplace for which the seller wants return reason codes.
+      # @param seller_fulfillment_order_id [String, nil] The identifier assigned to the item by the seller when the fulfillment order was created. The service uses this value to determine the marketplace for which the seller wants return reason codes.
+      # @param language [String, nil] The language that the `TranslatedDescription` property of the `ReasonCodeDetails` response object should be translated into.
+      # @param rdt [Array<RDT::Resource>, nil] send a restricted data token for these resources
+      # @return [AmazonSpClients::ApiResponse]
+      def list_return_reason_codes(seller_sku, marketplace_id: nil, seller_fulfillment_order_id: nil, language: nil, rdt: nil)
+        query = {
+          'sellerSku' => seller_sku,
+          'marketplaceId' => marketplace_id,
+          'sellerFulfillmentOrderId' => seller_fulfillment_order_id,
+          'language' => language
+        }
+
+        request(:get, '/fba/outbound/2020-07-01/returnReasonCodes', query: query, rdt: rdt)
+      end
+
+      # Requests that Amazon update the status of an order in the sandbox testing environment. This is a sandbox-only operation and must be directed to a sandbox endpoint. Refer to [Fulfillment Outbound Dynamic Sandbox Guide](https://developer-docs.amazon.com/sp-api/docs/fulfillment-outbound-dynamic-sandbox-guide) and [Selling Partner API sandbox](https://developer-docs.amazon.com/sp-api/docs/the-selling-partner-api-sandbox) for more information.
+      #
+      # @param body [Hash] The identifier assigned to the item by the seller when the fulfillment order was created. (SubmitFulfillmentOrderStatusUpdateRequest)
+      # @param seller_fulfillment_order_id [String] The identifier assigned to the item by the seller when the fulfillment order was created.
+      # @param rdt [Array<RDT::Resource>, nil] send a restricted data token for these resources
+      # @return [AmazonSpClients::ApiResponse]
+      def submit_fulfillment_order_status_update(body, seller_fulfillment_order_id, rdt: nil)
+        request(:put, "/fba/outbound/2020-07-01/fulfillmentOrders/#{encode(seller_fulfillment_order_id)}/status", body: body, rdt: rdt)
+      end
+
+      # Updates and/or requests shipment for a fulfillment order with an order hold on it. **Usage Plan:** | Rate (requests per second) | Burst | | ---- | ---- | | 2 | 30 | 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 have higher rate and burst values than those shown here. For more information, refer to [Usage Plans and Rate Limits in the Selling Partner API](https://developer-docs.amazon.com/sp-api/docs/usage-plans-and-rate-limits-in-the-sp-api).
+      #
+      # @param body [Hash] UpdateFulfillmentOrderRequest parameter (UpdateFulfillmentOrderRequest)
+      # @param seller_fulfillment_order_id [String] The identifier assigned to the item by the seller when the fulfillment order was created.
+      # @param rdt [Array<RDT::Resource>, nil] send a restricted data token for these resources
+      # @return [AmazonSpClients::ApiResponse]
+      def update_fulfillment_order(body, seller_fulfillment_order_id, rdt: nil)
+        request(:put, "/fba/outbound/2020-07-01/fulfillmentOrders/#{encode(seller_fulfillment_order_id)}", body: body, rdt: rdt)
+      end
+    end
+  end
+end

data/lib/amazon_sp_clients/v2/apis/listings_items_2021.rb

@@ -0,0 +1,144 @@
+# frozen_string_literal: true
+
+# Generated by lib/generator (bundle exec rake generate). Do not edit.
+
+require 'amazon_sp_clients/v2/api'
+
+module AmazonSpClients
+  module V2
+    # 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).
+    #
+    # OpenAPI spec version: 2021-08-01
+    class ListingsItems2021 < 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). **Usage Plan:** | Rate (requests per second) | Burst | | ---- | ---- | | 5 | 10 | 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-in-the-sp-api).
+      #
+      # @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, nil] 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 rdt [Array<RDT::Resource>, nil] send a restricted data token for these resources
+      # @return [AmazonSpClients::ApiResponse]
+      def delete_listings_item(seller_id, sku, marketplace_ids, issue_locale: nil, rdt: nil)
+        query = {
+          'marketplaceIds' => csv(marketplace_ids),
+          'issueLocale' => issue_locale
+        }
+
+        request(:delete, "/listings/2021-08-01/items/#{encode(seller_id)}/#{encode(sku)}", query: query, rdt: rdt)
+      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). **Usage Plan:** | Rate (requests per second) | Burst | | ---- | ---- | | 5 | 10 | 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-in-the-sp-api).
+      #
+      # @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, nil] 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>, nil] A comma-delimited list of data sets to include in the response. Default: `summaries`.
+      # @param rdt [Array<RDT::Resource>, nil] send a restricted data token for these resources
+      # @return [AmazonSpClients::ApiResponse]
+      def get_listings_item(seller_id, sku, marketplace_ids, issue_locale: nil, included_data: nil, rdt: nil)
+        query = {
+          'marketplaceIds' => csv(marketplace_ids),
+          'issueLocale' => issue_locale,
+          'includedData' => csv(included_data)
+        }
+
+        request(:get, "/listings/2021-08-01/items/#{encode(seller_id)}/#{encode(sku)}", query: query, rdt: rdt)
+      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. **Usage Plan:** | Rate (requests per second) | Burst | | ---- | ---- | | 5 | 5 | The `x-amzn-RateLimit-Limit` response header returns the usage plan rate limits that were applied to the requested operation, when available. The preceding table indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput can receive higher rate and burst values then those shown here. For more information, refer to [Usage Plans and Rate Limits](https://developer-docs.amazon.com/sp-api/docs/usage-plans-and-rate-limits-in-the-sp-api) in the Selling Partner API documentation.
+      #
+      # @param body [Hash] The request body schema for the `patchListingsItem` operation. (ListingsItemPatchRequest)
+      # @param marketplace_ids [Array<String>] A comma-delimited list of Amazon marketplace identifiers for the request.
+      # @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 included_data [Array<String>, nil] A comma-delimited list of data sets to include in the response. Default: `issues`.
+      # @param mode [String, nil] The mode of operation for the request.
+      # @param issue_locale [String, nil] 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 rdt [Array<RDT::Resource>, nil] send a restricted data token for these resources
+      # @return [AmazonSpClients::ApiResponse]
+      def patch_listings_item(body, marketplace_ids, seller_id, sku, included_data: nil, mode: nil, issue_locale: nil, rdt: nil)
+        query = {
+          'marketplaceIds' => csv(marketplace_ids),
+          'includedData' => csv(included_data),
+          'mode' => mode,
+          'issueLocale' => issue_locale
+        }
+
+        request(:patch, "/listings/2021-08-01/items/#{encode(seller_id)}/#{encode(sku)}", query: query, body: body, rdt: rdt)
+      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). **Usage Plan:** | Rate (requests per second) | Burst | | ---- | ---- | | 5 | 10 | 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-in-the-sp-api).
+      #
+      # @param body [Hash] The request body schema for the `putListingsItem` operation. (ListingsItemPutRequest)
+      # @param marketplace_ids [Array<String>] A comma-delimited list of Amazon marketplace identifiers for the request.
+      # @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 included_data [Array<String>, nil] A comma-delimited list of data sets to include in the response. Default: `issues`.
+      # @param mode [String, nil] The mode of operation for the request.
+      # @param issue_locale [String, nil] 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 rdt [Array<RDT::Resource>, nil] send a restricted data token for these resources
+      # @return [AmazonSpClients::ApiResponse]
+      def put_listings_item(body, marketplace_ids, seller_id, sku, included_data: nil, mode: nil, issue_locale: nil, rdt: nil)
+        query = {
+          'marketplaceIds' => csv(marketplace_ids),
+          'includedData' => csv(included_data),
+          'mode' => mode,
+          'issueLocale' => issue_locale
+        }
+
+        request(:put, "/listings/2021-08-01/items/#{encode(seller_id)}/#{encode(sku)}", query: query, body: body, rdt: rdt)
+      end
+
+      # Search for and return a list of selling partner listings items and their respective details. **Usage Plan:** | Rate (requests per second) | Burst | | ---- | ---- | | 5 | 5 | The `x-amzn-RateLimit-Limit` response header returns the usage plan rate limits that are applied to the requested operation, when available. The preceding table contains the default rate and burst values for this operation. Selling partners whose business demands require higher throughput might have higher rate and burst values than those shown here. For more information, refer to [Usage Plans and Rate Limits](https://developer-docs.amazon.com/sp-api/docs/usage-plans-and-rate-limits-in-the-sp-api).
+      #
+      # @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 issue_locale [String, nil] A locale that is used to localize issues. When not provided, the default language code of the first marketplace is used. Examples: "en_US", "fr_CA", "fr_FR". When a localization is not available in the specified locale, localized messages default to "en_US".
+      # @param included_data [Array<String>, nil] A comma-delimited list of datasets that you want to include in the response. Default: `summaries`.
+      # @param identifiers [Array<String>, nil] A comma-delimited list of product identifiers that you can use to search for listings items. **Note**: 1. This is required when you specify `identifiersType`. 2. You cannot use 'identifiers' if you specify `variationParentSku` or `packageHierarchySku`.
+      # @param identifiers_type [String, nil] A type of product identifiers that you can use to search for listings items. **Note**: This is required when `identifiers` is provided.
+      # @param variation_parent_sku [String, nil] Filters results to include listing items that are variation children of the specified SKU. **Note**: You cannot use `variationParentSku` if you include `identifiers` or `packageHierarchySku` in your request.
+      # @param package_hierarchy_sku [String, nil] Filter results to include listing items that contain or are contained by the specified SKU. **Note**: You cannot use `packageHierarchySku` if you include `identifiers` or `variationParentSku` in your request.
+      # @param created_after [String, nil] A date-time that is used to filter listing items. The response includes listings items that were created at or after this time. Values are in [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) date-time format.
+      # @param created_before [String, nil] A date-time that is used to filter listing items. The response includes listings items that were created at or before this time. Values are in [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) date-time format.
+      # @param last_updated_after [String, nil] A date-time that is used to filter listing items. The response includes listings items that were last updated at or after this time. Values are in [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) date-time format.
+      # @param last_updated_before [String, nil] A date-time that is used to filter listing items. The response includes listings items that were last updated at or before this time. Values are in [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) date-time format.
+      # @param with_issue_severity [Array<String>, nil] Filter results to include only listing items that have issues that match one or more of the specified severity levels.
+      # @param with_status [Array<String>, nil] Filter results to include only listing items that have the specified status.
+      # @param without_status [Array<String>, nil] Filter results to include only listing items that don't contain the specified statuses.
+      # @param sort_by [String, nil] An attribute by which to sort the returned listing items.
+      # @param sort_order [String, nil] The order in which to sort the result items.
+      # @param page_size [Integer, nil] The number of results that you want to include on each page.
+      # @param page_token [String, nil] A token that you can use to fetch a specific page when there are multiple pages of results.
+      # @param rdt [Array<RDT::Resource>, nil] send a restricted data token for these resources
+      # @return [AmazonSpClients::ApiResponse]
+      def search_listings_items(seller_id, marketplace_ids, issue_locale: nil, included_data: nil, identifiers: nil, identifiers_type: nil, variation_parent_sku: nil, package_hierarchy_sku: nil, created_after: nil, created_before: nil, last_updated_after: nil, last_updated_before: nil, with_issue_severity: nil, with_status: nil, without_status: nil, sort_by: nil, sort_order: nil, page_size: nil, page_token: nil, rdt: nil)
+        query = {
+          'marketplaceIds' => csv(marketplace_ids),
+          'issueLocale' => issue_locale,
+          'includedData' => csv(included_data),
+          'identifiers' => csv(identifiers),
+          'identifiersType' => identifiers_type,
+          'variationParentSku' => variation_parent_sku,
+          'packageHierarchySku' => package_hierarchy_sku,
+          'createdAfter' => created_after,
+          'createdBefore' => created_before,
+          'lastUpdatedAfter' => last_updated_after,
+          'lastUpdatedBefore' => last_updated_before,
+          'withIssueSeverity' => csv(with_issue_severity),
+          'withStatus' => csv(with_status),
+          'withoutStatus' => csv(without_status),
+          'sortBy' => sort_by,
+          'sortOrder' => sort_order,
+          'pageSize' => page_size,
+          'pageToken' => page_token
+        }
+
+        request(:get, "/listings/2021-08-01/items/#{encode(seller_id)}", query: query, rdt: rdt)
+      end
+    end
+  end
+end