python-amazon-sp-api 2.0.15__py3-none-any.whl → 2.1.3__py3-none-any.whl

sp_api/api/products/products_2022_05_01.py

@@ -0,0 +1,96 @@
+from typing import Optional, List, Dict, Union
+
+from sp_api.base import ApiResponse, Client, sp_endpoint
+from sp_api.api.products.products_definitions import (
+    GetCompetitiveSummaryBatch,
+    GetFeaturedOfferExpectedPriceBatch,
+)
+
+
+class ProductsV20220501(Client):
+    """
+    :links:
+        https://github.com/amzn/selling-partner-api-docs/blob/main/references/product-pricing-api/productPricingV0.md
+        https://developer-docs.amazon.com/sp-api/docs/product-pricing-api-v2022-05-01-reference
+    """
+
+    @sp_endpoint('/batches/products/pricing/2022-05-01/offer/featuredOfferExpectedPrice', method='POST')
+    def get_featured_offer_expected_price_batch(self, requests_: Optional[
+        Union[List[Dict], GetFeaturedOfferExpectedPriceBatch]], **kwargs) -> ApiResponse:
+        """
+        get_featured_offer_expected_price_batch(self, requests_, **kwargs) -> ApiResponse
+        
+        Returns the set of responses that correspond to the batched list of up to 40 requests defined in the request body. The response for each successful (HTTP status code 200) request in the set includes the computed listing price at or below which a seller can expect to become the featured offer (before applicable promotions). This is called the featured offer expected price (FOEP). Featured offer is not guaranteed because competing offers might change. Other offers might be featured based on factors such as fulfillment capabilities to a specific customer. The response to an unsuccessful request includes the available error text.
+        
+        **Usage Plan:**
+        
+        ======================================  ==============
+        Rate (requests per second)               Burst
+        ======================================  ==============
+        0.033                                   1
+        ======================================  ==============
+        
+        For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.
+        
+        Examples:
+            literal blocks::
+            
+                ProductsV20220501().get_featured_offer_expected_price_batch("value")
+        
+        Args:
+            getFeaturedOfferExpectedPriceBatchRequestBody: GetFeaturedOfferExpectedPriceBatchRequest | required The batch of `getFeaturedOfferExpectedPrice` requests.
+        
+        Returns:
+            ApiResponse
+        """
+        if isinstance(requests_, GetFeaturedOfferExpectedPriceBatch):
+            get_featured_offer_expected_price_batch_request = requests_.to_dict()
+        else:
+            get_featured_offer_expected_price_batch_request = {"requests": requests_}
+
+        return self._request(
+            kwargs.pop('path'),
+            data=get_featured_offer_expected_price_batch_request,
+            params={**kwargs},
+            add_marketplace=False
+        )
+
+    @sp_endpoint('/batches/products/pricing/2022-05-01/items/competitiveSummary', method='POST')
+    def get_competitive_summary_batch(self, requests_: Optional[Union[List[Dict], GetCompetitiveSummaryBatch]], **kwargs) -> ApiResponse:
+        """
+        get_competitive_summary_batch(self, requests_, **kwargs) -> ApiResponse
+        
+        Returns the competitive summary response, including featured buying options for the ASIN and `marketplaceId` combination.
+        
+        **Usage Plan:**
+        
+        ======================================  ==============
+        Rate (requests per second)               Burst
+        ======================================  ==============
+        0.033                                   1
+        ======================================  ==============
+        
+        For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.
+        
+        Examples:
+            literal blocks::
+            
+                ProductsV20220501().get_competitive_summary_batch("value")
+        
+        Args:
+            requests: CompetitiveSummaryBatchRequest | required The batch of `getCompetitiveSummary` requests.
+        
+        Returns:
+            ApiResponse
+        """
+        if isinstance(requests_, GetCompetitiveSummaryBatch):
+            get_competitive_summary_batch_request = requests_.to_dict()
+        else:
+            get_competitive_summary_batch_request = {"requests": requests_}
+
+        return self._request(
+            kwargs.pop('path'),
+            data=get_competitive_summary_batch_request,
+            params={**kwargs},
+            add_marketplace=False
+        )

sp_api/api/products/products_v0.py

@@ -0,0 +1,389 @@
+from typing import Optional, List, Dict, Union
+
+from sp_api.base import ApiResponse, Client, fill_query_params, sp_endpoint
+from sp_api.api.products.products_definitions import (
+    GetItemOffersBatchRequest,
+    GetListingOffersBatchRequest,
+)
+from sp_api.util import ensure_csv
+
+
+class ProductsV0(Client):
+    """
+    :links:
+        https://github.com/amzn/selling-partner-api-docs/blob/main/references/product-pricing-api/productPricingV0.md
+        https://developer-docs.amazon.com/sp-api/docs/product-pricing-api-v2022-05-01-reference
+    """
+
+    @sp_endpoint("/products/pricing/v0/price", method="GET")
+    def get_product_pricing_for_skus(
+        self, seller_sku_list: [str], item_condition=None, offer_type=None, **kwargs
+    ) -> ApiResponse:
+        """
+        get_product_pricing_for_skus(self, seller_sku_list, item_condition, offer_type, **kwargs) -> ApiResponse
+        
+        Returns pricing information for a seller's offer listings based on seller SKU or ASIN.
+        
+        **Note:** The parameters associated with this operation may contain special characters that require URL encoding to call the API. To avoid errors with SKUs when encoding URLs, refer to [URL Encoding](https://developer-docs.amazon.com/sp-api/docs/url-encoding).
+        
+        **Usage Plan:**
+        
+        ======================================  ==============
+        Rate (requests per second)               Burst
+        ======================================  ==============
+        0.5                                     1
+        ======================================  ==============
+        
+        For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.
+        
+        Examples:
+            literal blocks::
+            
+                ProductsV0().get_product_pricing_for_skus("value", "value", "value")
+        
+        Args:
+            key MarketplaceId: object | required A marketplace identifier. Specifies the marketplace for which prices are returned.
+            key Asins: object |  A list of up to twenty Amazon Standard Identification Number (ASIN) values used to identify items in the given marketplace.
+            key Skus: object |  A list of up to twenty seller SKU values used to identify items in the given marketplace.
+            key ItemType: object | required Indicates whether ASIN values or seller SKU values are used to identify items. If you specify Asin, the information in the response will be dependent on the list of Asins you provide in the Asins parameter. If you specify Sku, the information in the response will be dependent on the list of Skus you provide in the Skus parameter.
+            key ItemCondition: object |  Filters the offer listings based on item condition. Possible values: New, Used, Collectible, Refurbished, Club.
+            key OfferType: object |  Indicates whether to request pricing information for the seller's B2C or B2B offers. Default is B2C.
+        
+        Returns:
+            ApiResponse
+        """
+        if item_condition is not None:
+            kwargs["ItemCondition"] = item_condition
+        if offer_type is not None:
+            kwargs["OfferType"] = offer_type
+
+        return self._create_get_pricing_request(seller_sku_list, "Sku", **kwargs)
+
+    @sp_endpoint("/products/pricing/v0/price", method="GET")
+    def get_product_pricing_for_asins(
+        self, asin_list: [str], item_condition=None, offer_type=None, **kwargs
+    ) -> ApiResponse:
+        """
+        get_product_pricing_for_asins(self, asin_list, item_condition, offer_type, **kwargs) -> ApiResponse
+        
+        Returns pricing information for a seller's offer listings based on seller SKU or ASIN.
+        
+        **Note:** The parameters associated with this operation may contain special characters that require URL encoding to call the API. To avoid errors with SKUs when encoding URLs, refer to [URL Encoding](https://developer-docs.amazon.com/sp-api/docs/url-encoding).
+        
+        **Usage Plan:**
+        
+        ======================================  ==============
+        Rate (requests per second)               Burst
+        ======================================  ==============
+        0.5                                     1
+        ======================================  ==============
+        
+        For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.
+        
+        Examples:
+            literal blocks::
+            
+                ProductsV0().get_product_pricing_for_asins("value", "value", "value")
+        
+        Args:
+            key MarketplaceId: object | required A marketplace identifier. Specifies the marketplace for which prices are returned.
+            key Asins: object |  A list of up to twenty Amazon Standard Identification Number (ASIN) values used to identify items in the given marketplace.
+            key Skus: object |  A list of up to twenty seller SKU values used to identify items in the given marketplace.
+            key ItemType: object | required Indicates whether ASIN values or seller SKU values are used to identify items. If you specify Asin, the information in the response will be dependent on the list of Asins you provide in the Asins parameter. If you specify Sku, the information in the response will be dependent on the list of Skus you provide in the Skus parameter.
+            key ItemCondition: object |  Filters the offer listings based on item condition. Possible values: New, Used, Collectible, Refurbished, Club.
+            key OfferType: object |  Indicates whether to request pricing information for the seller's B2C or B2B offers. Default is B2C.
+        
+        Returns:
+            ApiResponse
+        """
+        if item_condition is not None:
+            kwargs["ItemCondition"] = item_condition
+        if offer_type is not None:
+            kwargs["OfferType"] = offer_type
+
+        return self._create_get_pricing_request(asin_list, "Asin", **kwargs)
+
+
+    @sp_endpoint("/products/pricing/v0/competitivePrice", method="GET")
+    def get_competitive_pricing_for_skus(
+        self, seller_sku_list: [str], customer_type=None, **kwargs
+    ) -> ApiResponse:
+        """
+        get_competitive_pricing_for_skus(self, seller_sku_list, customer_type, **kwargs) -> ApiResponse
+        
+        Returns competitive pricing information for a seller's offer listings based on seller SKU or ASIN.
+        
+        **Note:** The parameters associated with this operation may contain special characters that require URL encoding to call the API. To avoid errors with SKUs when encoding URLs, refer to [URL Encoding](https://developer-docs.amazon.com/sp-api/docs/url-encoding).
+        
+        **Usage Plan:**
+        
+        ======================================  ==============
+        Rate (requests per second)               Burst
+        ======================================  ==============
+        0.5                                     1
+        ======================================  ==============
+        
+        For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.
+        
+        Examples:
+            literal blocks::
+            
+                ProductsV0().get_competitive_pricing_for_skus("value", "value")
+        
+        Args:
+            key MarketplaceId: object | required A marketplace identifier. Specifies the marketplace for which prices are returned.
+            key Asins: object |  A list of up to twenty Amazon Standard Identification Number (ASIN) values used to identify items in the given marketplace.
+            key Skus: object |  A list of up to twenty seller SKU values used to identify items in the given marketplace.
+            key ItemType: object | required Indicates whether ASIN values or seller SKU values are used to identify items. If you specify Asin, the information in the response will be dependent on the list of Asins you provide in the Asins parameter. If you specify Sku, the information in the response will be dependent on the list of Skus you provide in the Skus parameter. Possible values: Asin, Sku.
+            key CustomerType: object |  Indicates whether to request pricing information from the point of view of Consumer or Business buyers. Default is Consumer.
+        
+        Returns:
+            ApiResponse
+        """
+
+        if customer_type is not None:
+            kwargs["CustomerType"] = customer_type
+
+        return self._create_get_pricing_request(seller_sku_list, "Sku", **kwargs)
+
+    @sp_endpoint("/products/pricing/v0/competitivePrice", method="GET")
+    def get_competitive_pricing_for_asins(
+        self, asin_list: [str], customer_type=None, **kwargs
+    ) -> ApiResponse:
+        """
+        get_competitive_pricing_for_asins(self, asin_list, customer_type, **kwargs) -> ApiResponse
+        
+        Returns competitive pricing information for a seller's offer listings based on seller SKU or ASIN.
+        
+        **Note:** The parameters associated with this operation may contain special characters that require URL encoding to call the API. To avoid errors with SKUs when encoding URLs, refer to [URL Encoding](https://developer-docs.amazon.com/sp-api/docs/url-encoding).
+        
+        **Usage Plan:**
+        
+        ======================================  ==============
+        Rate (requests per second)               Burst
+        ======================================  ==============
+        0.5                                     1
+        ======================================  ==============
+        
+        For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.
+        
+        Examples:
+            literal blocks::
+            
+                ProductsV0().get_competitive_pricing_for_asins("value", "value")
+        
+        Args:
+            key MarketplaceId: object | required A marketplace identifier. Specifies the marketplace for which prices are returned.
+            key Asins: object |  A list of up to twenty Amazon Standard Identification Number (ASIN) values used to identify items in the given marketplace.
+            key Skus: object |  A list of up to twenty seller SKU values used to identify items in the given marketplace.
+            key ItemType: object | required Indicates whether ASIN values or seller SKU values are used to identify items. If you specify Asin, the information in the response will be dependent on the list of Asins you provide in the Asins parameter. If you specify Sku, the information in the response will be dependent on the list of Skus you provide in the Skus parameter. Possible values: Asin, Sku.
+            key CustomerType: object |  Indicates whether to request pricing information from the point of view of Consumer or Business buyers. Default is Consumer.
+        
+        Returns:
+            ApiResponse
+        """
+        if customer_type is not None:
+            kwargs["CustomerType"] = customer_type
+
+        return self._create_get_pricing_request(asin_list, "Asin", **kwargs)
+
+
+    @sp_endpoint("/products/pricing/v0/listings/{}/offers", method="GET")
+    def get_listings_offer(
+        self, seller_sku: str, item_condition: str, customer_type: str = None, **kwargs
+    ) -> ApiResponse:
+        """
+        get_listings_offer(self, seller_sku, item_condition, customer_type, **kwargs) -> ApiResponse
+        
+        Returns the lowest priced offers for a single SKU listing.
+        
+        **Note:** The parameters associated with this operation may contain special characters that require URL encoding to call the API. To avoid errors with SKUs when encoding URLs, refer to [URL Encoding](https://developer-docs.amazon.com/sp-api/docs/url-encoding).
+        
+        **Usage Plan:**
+        
+        ======================================  ==============
+        Rate (requests per second)               Burst
+        ======================================  ==============
+        1                                       2
+        ======================================  ==============
+        
+        For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.
+        
+        Examples:
+            literal blocks::
+            
+                ProductsV0().get_listings_offer("value", "value", "value")
+        
+        Args:
+            key MarketplaceId: object | required A marketplace identifier. Specifies the marketplace for which prices are returned.
+            key ItemCondition: object | required Filters the offer listings based on item condition. Possible values: New, Used, Collectible, Refurbished, Club.
+            SellerSKU: object | required Identifies an item in the given marketplace. SellerSKU is qualified by the seller's SellerId, which is included with every operation that you submit.
+            key CustomerType: object |  Indicates whether to request Consumer or Business offers. Default is Consumer.
+        
+        Returns:
+            ApiResponse
+        """
+        kwargs["ItemCondition"] = item_condition
+
+        if customer_type is not None:
+            kwargs["CustomerType"] = customer_type
+
+        return self._request(
+            fill_query_params(kwargs.pop("path"), seller_sku), params={**kwargs}
+        )
+
+    @sp_endpoint("/products/pricing/v0/items/{}/offers", method="GET")
+    def get_item_offers(
+        self, asin: str, item_condition: str, customer_type: str = None, **kwargs
+    ) -> ApiResponse:
+        """
+        get_item_offers(self, asin, item_condition, customer_type, **kwargs) -> ApiResponse
+        
+        Returns the lowest priced offers for a single item based on ASIN.
+        
+        **Usage Plan:**
+        
+        ======================================  ==============
+        Rate (requests per second)               Burst
+        ======================================  ==============
+        0.5                                     1
+        ======================================  ==============
+        
+        For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.
+        
+        Examples:
+            literal blocks::
+            
+                ProductsV0().get_item_offers("value", "value", "value")
+        
+        Args:
+            key MarketplaceId: object | required A marketplace identifier. Specifies the marketplace for which prices are returned.
+            key ItemCondition: object | required Filters the offer listings to be considered based on item condition. Possible values: New, Used, Collectible, Refurbished, Club.
+            Asin: object | required The Amazon Standard Identification Number (ASIN) of the item.
+            key CustomerType: object |  Indicates whether to request Consumer or Business offers. Default is Consumer.
+        
+        Returns:
+            ApiResponse
+        """
+        kwargs["ItemCondition"] = item_condition
+
+        if customer_type is not None:
+            kwargs["CustomerType"] = customer_type
+
+        return self._request(
+            fill_query_params(kwargs.pop("path"), asin), params={**kwargs}
+        )
+
+    @sp_endpoint("/batches/products/pricing/v0/itemOffers", method="POST")
+    def get_item_offers_batch(
+        self,
+        requests_: Optional[Union[List[Dict], GetItemOffersBatchRequest]] = None,
+        **kwargs,
+    ) -> ApiResponse:
+        """
+        get_item_offers_batch(self, requests_, **kwargs) -> ApiResponse
+        
+        Returns the lowest priced offers for a batch of items based on ASIN.
+        
+        **Usage Plan:**
+        
+        ======================================  ==============
+        Rate (requests per second)               Burst
+        ======================================  ==============
+        0.1                                     1
+        ======================================  ==============
+        
+        For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.
+        
+        Examples:
+            literal blocks::
+            
+                ProductsV0().get_item_offers_batch("value")
+        
+        Args:
+            getItemOffersBatchRequestBody: GetItemOffersBatchRequest | required The request associated with the `getItemOffersBatch` API call.
+        
+        Returns:
+            ApiResponse
+        """
+        if isinstance(requests_, GetItemOffersBatchRequest):
+            get_item_offers_batch_request = requests_.to_dict()
+        else:
+            get_item_offers_batch_request = {"requests": requests_}
+
+        return self._request(
+            kwargs.pop("path"),
+            data=get_item_offers_batch_request,
+            params={**kwargs},
+            add_marketplace=False,
+        )
+
+    @sp_endpoint("/batches/products/pricing/v0/listingOffers", method="POST")
+    def get_listing_offers_batch(
+        self,
+        requests_: Optional[Union[List[Dict], GetListingOffersBatchRequest]] = None,
+        **kwargs,
+    ) -> ApiResponse:
+        """
+        get_listing_offers_batch(self, requests_, **kwargs) -> ApiResponse
+        
+        Returns the lowest priced offers for a batch of listings by SKU.
+        
+        **Usage Plan:**
+        
+        ======================================  ==============
+        Rate (requests per second)               Burst
+        ======================================  ==============
+        0.5                                     1
+        ======================================  ==============
+        
+        For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.
+        
+        Examples:
+            literal blocks::
+            
+                ProductsV0().get_listing_offers_batch("value")
+        
+        Args:
+            getListingOffersBatchRequestBody: GetListingOffersBatchRequest | required The request associated with the `getListingOffersBatch` API call.
+        
+        Returns:
+            ApiResponse
+        """
+        if isinstance(requests_, GetListingOffersBatchRequest):
+            get_listing_offers_batch_request = requests_.to_dict()
+        else:
+            get_listing_offers_batch_request = {"requests": requests_}
+
+        return self._request(
+            kwargs.pop("path"),
+            data=get_listing_offers_batch_request,
+            params={**kwargs},
+            add_marketplace=False,
+        )
+
+    def _create_get_pricing_request(self, item_list, item_type, **kwargs):
+        items_csv = ensure_csv(item_list)
+        return self._request(
+            kwargs.pop("path"),
+            params={
+                **{f"{item_type}s": items_csv},
+                "ItemType": item_type,
+                **(
+                    {"ItemCondition": kwargs.pop("ItemCondition")}
+                    if "ItemCondition" in kwargs
+                    else {}
+                ),
+                **(
+                    {"CustomerType": kwargs.pop("CustomerType")}
+                    if "CustomerType" in kwargs
+                    else {}
+                ),
+                **(
+                    {"OfferType": kwargs.pop("OfferType")}
+                    if "OfferType" in kwargs
+                    else {}
+                ),
+                "MarketplaceId": kwargs.get("MarketplaceId", self.marketplace_id),
+            },
+        )

sp_api/api/replenishment/replenishment.py

@@ -19,38 +19,29 @@ class Replenishment(Client):
     def get_selling_partner_metrics(self, **kwargs) -> ApiResponse:
         """
         get_selling_partner_metrics(self, **kwargs) -> ApiResponse
-
+        
         Returns aggregated replenishment program metrics for a selling partner.
-
+        
         **Usage Plan:**
-
-        | Rate (requests per second) | Burst |
-        | ---- | ---- |
-        | 1 | 1 |
-
-        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).
-
+        
+        ======================================  ==============
+        Rate (requests per second)               Burst
+        ======================================  ==============
+        1                                       1
+        ======================================  ==============
+        
+        For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.
+        
+        Examples:
+            literal blocks::
+            
+                Replenishment().get_selling_partner_metrics()
+        
         Args:
-
-            body: |  {'description': 'The request body for the `getSellingPartnerMetrics` operation.',
-                     'properties': {'aggregationFrequency': {'$ref': '#/definitions/AggregationFrequency'},
-                                    'marketplaceId': {'$ref': '#/definitions/MarketplaceId',
-                                                      'description': 'The marketplace identifier. The supported marketplaces for both sellers and vendors are US, CA, ES, UK, FR, IT, IN, DE and JP. The supported marketplaces for vendors only are BR, AU, MX, AE and NL.  '
-                                                                     'Refer to [Marketplace IDs](https://developer-docs.amazon.com/sp-api/docs/marketplace-ids) to find the identifier for the marketplace.'},
-                                    'metrics': {'description': 'The list of metrics requested. If no metric value is provided, data for all of the metrics will be returned.',
-                                                'items': {'$ref': '#/definitions/Metric'},
-                                                'minItems': 1,
-                                                'type': 'array',
-                                                'uniqueItems': True},
-                                    'programTypes': {'$ref': '#/definitions/ProgramTypes', 'description': 'The list of replenishment program types for which to return metrics.'},
-                                    'timeInterval': {'$ref': '#/definitions/TimeInterval', 'description': 'A time interval used to compute metrics.'},
-                                    'timePeriodType': {'$ref': '#/definitions/TimePeriodType'}},
-                     'required': ['timeInterval', 'timePeriodType', 'programTypes', 'marketplaceId'],
-                     'type': 'object'}
-
-
+            body: GetSellingPartnerMetricsRequest |  The request body for the `getSellingPartnerMetrics` operation.
+        
         Returns:
-            ApiResponse:
+            ApiResponse
         """
 
         return self._request(kwargs.pop("path"), data=kwargs)
@@ -59,30 +50,29 @@ class Replenishment(Client):
     def list_offer_metrics(self, **kwargs) -> ApiResponse:
         """
         list_offer_metrics(self, **kwargs) -> ApiResponse
-
+        
         Returns aggregated replenishment program metrics for a selling partner's offers.
-
+        
         **Usage Plan:**
-
-        | Rate (requests per second) | Burst |
-        | ---- | ---- |
-        | 1 | 1 |
-
-        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).
-
+        
+        ======================================  ==============
+        Rate (requests per second)               Burst
+        ======================================  ==============
+        1                                       1
+        ======================================  ==============
+        
+        For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.
+        
+        Examples:
+            literal blocks::
+            
+                Replenishment().list_offer_metrics()
+        
         Args:
-
-            body: |  {'description': 'The request body for the `listOfferMetrics` operation.',
-                     'properties': {'filters': {'$ref': '#/definitions/ListOfferMetricsRequestFilters',
-                                                'description': 'Use these parameters to filter results. Any result must match all provided parameters. For any parameter that is an array, the result must match at least one element in the provided array.'},
-                                    'pagination': {'$ref': '#/definitions/ListOfferMetricsRequestPagination', 'description': 'Use these parameters to paginate through the response.'},
-                                    'sort': {'$ref': '#/definitions/ListOfferMetricsRequestSort', 'description': 'Use these parameters to sort the response.'}},
-                     'required': ['pagination', 'filters'],
-                     'type': 'object'}
-
-
+            body: ListOfferMetricsRequest |  The request body for the `listOfferMetrics` operation.
+        
         Returns:
-            ApiResponse:
+            ApiResponse
         """
 
         return self._request(kwargs.pop("path"), data=kwargs)
@@ -91,30 +81,29 @@ class Replenishment(Client):
     def list_offers(self, **kwargs) -> ApiResponse:
         """
         list_offers(self, **kwargs) -> ApiResponse
-
-        Returns the details of a selling partner's replenishment program offers. Note that this operation only supports sellers at this time.
-
+        
+        Returns the details of a selling partner's replenishment program offers.
+        
         **Usage Plan:**
-
-        | Rate (requests per second) | Burst |
-        | ---- | ---- |
-        | 1 | 1 |
-
-        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).
-
+        
+        ======================================  ==============
+        Rate (requests per second)               Burst
+        ======================================  ==============
+        1                                       1
+        ======================================  ==============
+        
+        For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.
+        
+        Examples:
+            literal blocks::
+            
+                Replenishment().list_offers()
+        
         Args:
-
-            body: |  {'description': 'The request body for the `listOffers` operation.',
-                     'properties': {'filters': {'$ref': '#/definitions/ListOffersRequestFilters',
-                                                'description': 'Use these parameters to filter results. Any result must match all provided parameters. For any parameter that is an array, the result must match at least one element in the provided array.'},
-                                    'pagination': {'$ref': '#/definitions/ListOffersRequestPagination', 'description': 'Use these parameters to paginate through the response.'},
-                                    'sort': {'$ref': '#/definitions/ListOffersRequestSort', 'description': 'Use these parameters to sort the response.'}},
-                     'required': ['pagination', 'filters'],
-                     'type': 'object'}
-
-
+            body: ListOffersRequest |  The request body for the `listOffers` operation.
+        
         Returns:
-            ApiResponse:
+            ApiResponse
         """
 
         return self._request(kwargs.pop("path"), data=kwargs)