python-amazon-sp-api 1.7.5__py3-none-any.whl → 2.0.10__py3-none-any.whl

sp_api/api/fba_inbound_eligibility/fba_inbound_eligibility.py

@@ -1,18 +1,23 @@
 import urllib.parse
 
-from sp_api.base import Client, sp_endpoint, fill_query_params, IneligibilityReasonList, ApiResponse
+from sp_api.base import (
+    Client,
+    sp_endpoint,
+    fill_query_params,
+    IneligibilityReasonList,
+    ApiResponse,
+)
 
 
 class FbaInboundEligibility(Client):
     """
     FbaInboundEligibility SP-API Client
-    :link: 
+    :link:
 
     With the FBA Inbound Eligibility API, you can build applications that let sellers get eligibility previews for items before shipping them to Amazon's fulfillment centers. With this API you can find out if an item is eligible for inbound shipment to Amazon's fulfillment centers in a specific marketplace. You can also find out if an item is eligible for using the manufacturer barcode for FBA inventory tracking. Sellers can use this information to inform their decisions about which items to ship Amazon's fulfillment centers.
     """
 
-
-    @sp_endpoint('/fba/inbound/v1/eligibility/itemPreview', method='GET')
+    @sp_endpoint("/fba/inbound/v1/eligibility/itemPreview", method="GET")
     def get_item_eligibility_preview(self, **kwargs) -> ApiResponse:
         """
         get_item_eligibility_preview(self, **kwargs) -> ApiResponse
@@ -34,14 +39,14 @@ class FbaInboundEligibility(Client):
             key marketplaceIds:array |  The identifier for the marketplace in which you want to determine eligibility. Required only when program=INBOUND.
             key asin:string | * REQUIRED The ASIN of the item for which you want an eligibility preview.
             key program:string | * REQUIRED The program that you want to check eligibility against.
-        
+
 
         Returns:
             ApiResponse:
         """
-        return self._request(kwargs.pop('path'),  params=kwargs)
+        return self._request(kwargs.pop("path"), params=kwargs)
 
-    @sp_endpoint('/fba/inbound/v1/eligibility/itemPreview', method='GET')
+    @sp_endpoint("/fba/inbound/v1/eligibility/itemPreview", method="GET")
     def get_item_eligibility_preview_extended(self, **kwargs) -> ApiResponse:
         """
         get_item_eligibility_preview_extended(self, **kwargs) -> ApiResponse
@@ -69,18 +74,23 @@ class FbaInboundEligibility(Client):
             ApiResponse:
         """
 
-        api_response = self._request(kwargs.pop('path'), params=kwargs)
+        api_response = self._request(kwargs.pop("path"), params=kwargs)
 
-        if api_response.payload.get("ineligibilityReasonList") and api_response.payload.get("isEligibleForProgram") is False:
+        if (
+            api_response.payload.get("ineligibilityReasonList")
+            and api_response.payload.get("isEligibleForProgram") is False
+        ):
             ineligibility_list = api_response.payload.get("ineligibilityReasonList")
             errors = []
             for ineligibility_option in ineligibility_list:
                 try:
-                    errors.append(ineligibility_option + ": " + IneligibilityReasonList[ineligibility_option].value)
+                    errors.append(
+                        ineligibility_option
+                        + ": "
+                        + IneligibilityReasonList[ineligibility_option].value
+                    )
                 except KeyError as error:
                     errors.append(error)
-            api_response.payload.update({
-                "ineligibilityReasonListMessage": errors
-            })
+            api_response.payload.update({"ineligibilityReasonListMessage": errors})
 
         return api_response

sp_api/api/fba_small_and_light/fba_small_and_light.py

@@ -6,17 +6,21 @@ from sp_api.base import Client, sp_endpoint, fill_query_params, ApiResponse, dep
 class FbaSmallAndLight(Client):
     """
     FbaSmallAndLight SP-API Client
-    :link: 
+    :link:
 
     The Selling Partner API for FBA Small and Light lets you help sellers manage their listings in the Small and Light program. The program reduces the cost of fulfilling orders for small and lightweight FBA inventory. You can enroll or remove items from the program and check item eligibility and enrollment status. You can also preview the estimated program fees charged to a seller for items sold while enrolled in the program.
     """
 
     @deprecated
-    def get_small_and_light_enrollment_by_seller_s_k_u(self, sellerSKU, **kwargs) -> ApiResponse:
+    def get_small_and_light_enrollment_by_seller_s_k_u(
+        self, sellerSKU, **kwargs
+    ) -> ApiResponse:
         return self.get_small_and_light_enrollment_by_seller_sku(sellerSKU, **kwargs)
 
-    @sp_endpoint('/fba/smallAndLight/v1/enrollments/{}', method='GET')
-    def get_small_and_light_enrollment_by_seller_sku(self, seller_sku, **kwargs) -> ApiResponse:
+    @sp_endpoint("/fba/smallAndLight/v1/enrollments/{}", method="GET")
+    def get_small_and_light_enrollment_by_seller_sku(
+        self, seller_sku, **kwargs
+    ) -> ApiResponse:
         """
         get_small_and_light_enrollment_by_seller_s_k_u(self, sellerSKU, **kwargs) -> ApiResponse
 
@@ -40,14 +44,20 @@ class FbaSmallAndLight(Client):
             ApiResponse:
         """
 
-        return self._request(fill_query_params(kwargs.pop('path'), seller_sku), params=kwargs)
+        return self._request(
+            fill_query_params(kwargs.pop("path"), seller_sku), params=kwargs
+        )
 
     @deprecated
-    def put_small_and_light_enrollment_by_seller_s_k_u(self, sellerSKU, **kwargs) -> ApiResponse:
+    def put_small_and_light_enrollment_by_seller_s_k_u(
+        self, sellerSKU, **kwargs
+    ) -> ApiResponse:
         return self.put_small_and_light_enrollment_by_seller_sku(sellerSKU, **kwargs)
 
-    @sp_endpoint('/fba/smallAndLight/v1/enrollments/{}', method='PUT')
-    def put_small_and_light_enrollment_by_seller_sku(self, seller_sku, **kwargs) -> ApiResponse:
+    @sp_endpoint("/fba/smallAndLight/v1/enrollments/{}", method="PUT")
+    def put_small_and_light_enrollment_by_seller_sku(
+        self, seller_sku, **kwargs
+    ) -> ApiResponse:
         """
         put_small_and_light_enrollment_by_seller_s_k_u(self, sellerSKU, **kwargs) -> ApiResponse
 
@@ -72,15 +82,23 @@ class FbaSmallAndLight(Client):
             ApiResponse:
         """
 
-        return self._request(fill_query_params(kwargs.pop('path'), seller_sku),
-                             params={'marketplaceIds': kwargs.get('marketplaceIds', self.marketplace_id)})
+        return self._request(
+            fill_query_params(kwargs.pop("path"), seller_sku),
+            params={
+                "marketplaceIds": kwargs.get("marketplaceIds", self.marketplace_id)
+            },
+        )
 
     @deprecated
-    def delete_small_and_light_enrollment_by_seller_s_k_u(self, sellerSKU, **kwargs) -> ApiResponse:
+    def delete_small_and_light_enrollment_by_seller_s_k_u(
+        self, sellerSKU, **kwargs
+    ) -> ApiResponse:
         return self.delete_small_and_light_enrollment_by_seller_sku(sellerSKU, **kwargs)
 
-    @sp_endpoint('/fba/smallAndLight/v1/enrollments/{}', method='DELETE')
-    def delete_small_and_light_enrollment_by_seller_sku(self, seller_sku, **kwargs) -> ApiResponse:
+    @sp_endpoint("/fba/smallAndLight/v1/enrollments/{}", method="DELETE")
+    def delete_small_and_light_enrollment_by_seller_sku(
+        self, seller_sku, **kwargs
+    ) -> ApiResponse:
         """
         delete_small_and_light_enrollment_by_seller_s_k_u(self, sellerSKU, **kwargs) -> ApiResponse
 
@@ -104,14 +122,20 @@ class FbaSmallAndLight(Client):
             ApiResponse:
         """
 
-        return self._request(fill_query_params(kwargs.pop('path'), seller_sku), data=kwargs)
+        return self._request(
+            fill_query_params(kwargs.pop("path"), seller_sku), data=kwargs
+        )
 
     @deprecated
-    def get_small_and_light_eligibility_by_seller_s_k_u(self, sellerSKU, **kwargs) -> ApiResponse:
+    def get_small_and_light_eligibility_by_seller_s_k_u(
+        self, sellerSKU, **kwargs
+    ) -> ApiResponse:
         return self.get_small_and_light_eligibility_by_seller_sku(sellerSKU, **kwargs)
 
-    @sp_endpoint('/fba/smallAndLight/v1/eligibilities/{}', method='GET')
-    def get_small_and_light_eligibility_by_seller_sku(self, seller_sku, **kwargs) -> ApiResponse:
+    @sp_endpoint("/fba/smallAndLight/v1/eligibilities/{}", method="GET")
+    def get_small_and_light_eligibility_by_seller_sku(
+        self, seller_sku, **kwargs
+    ) -> ApiResponse:
         """
         get_small_and_light_eligibility_by_seller_s_k_u(self, sellerSKU, **kwargs) -> ApiResponse
 
@@ -136,9 +160,11 @@ class FbaSmallAndLight(Client):
             ApiResponse:
         """
 
-        return self._request(fill_query_params(kwargs.pop('path'), seller_sku), params=kwargs)
+        return self._request(
+            fill_query_params(kwargs.pop("path"), seller_sku), params=kwargs
+        )
 
-    @sp_endpoint('/fba/smallAndLight/v1/feePreviews', method='POST')
+    @sp_endpoint("/fba/smallAndLight/v1/feePreviews", method="POST")
     def get_small_and_light_fee_preview(self, **kwargs) -> ApiResponse:
         """
         get_small_and_light_fee_preview(self, **kwargs) -> ApiResponse
@@ -175,4 +201,4 @@ class FbaSmallAndLight(Client):
             ApiResponse:
         """
 
-        return self._request(kwargs.pop('path'), data=kwargs)
+        return self._request(kwargs.pop("path"), data=kwargs)

sp_api/api/feeds/feeds.py

@@ -1,8 +1,9 @@
 import zlib
 
-import requests
+import httpx
 
 from sp_api.base import Client, sp_endpoint, fill_query_params, ApiResponse
+from sp_api.util import should_add_marketplace
 
 
 class Feeds(Client):
@@ -13,7 +14,7 @@ class Feeds(Client):
     The Selling Partner API for Feeds lets you upload data to Amazon on behalf of a selling partner.
     """
 
-    @sp_endpoint('/feeds/2021-06-30/feeds', method='GET')
+    @sp_endpoint("/feeds/2021-06-30/feeds", method="GET")
     def get_feeds(self, **kwargs) -> ApiResponse:
         """
         get_feeds(self, **kwargs) -> ApiResponse
@@ -34,10 +35,14 @@ class Feeds(Client):
             ApiResponse:
         """
 
-        add_marketplace = not 'nextToken' in kwargs
-        return self._request(kwargs.pop('path'), params=kwargs, add_marketplace=add_marketplace)
+        add_marketplace = should_add_marketplace(kwargs, "nextToken")
+        return self._request(
+            kwargs.pop("path"), params=kwargs, add_marketplace=add_marketplace
+        )
 
-    def submit_feed(self, feed_type, file, content_type='text/tsv', **kwargs) -> [ApiResponse, ApiResponse]:
+    def submit_feed(
+        self, feed_type, file, content_type="text/tsv", **kwargs
+    ) -> [ApiResponse, ApiResponse]:
         """
         submit_feed(self, feed_type: str, file: File or File like, content_type='text/tsv', **kwargs) -> [ApiResponse, ApiResponse]
         Combines `create_feed_document` and `create_feed`, uploads the file and sends the feed to amazon.
@@ -69,9 +74,11 @@ class Feeds(Client):
             [ApiResponse:, ApiResponse:]
         """
         document_response = self.create_feed_document(file, content_type)
-        return document_response, self.create_feed(feed_type, document_response.payload.get('feedDocumentId'), **kwargs)
+        return document_response, self.create_feed(
+            feed_type, document_response.payload.get("feedDocumentId"), **kwargs
+        )
 
-    @sp_endpoint('/feeds/2021-06-30/feeds', method='POST')
+    @sp_endpoint("/feeds/2021-06-30/feeds", method="POST")
     def create_feed(self, feed_type, input_feed_document_id, **kwargs) -> ApiResponse:
         """
         create_feed(self, feed_type: str, input_feed_document_id: str, **kwargs) -> ApiResponse
@@ -104,13 +111,13 @@ class Feeds(Client):
             ApiResponse:
         """
         data = {
-            'feedType': feed_type,
-            'inputFeedDocumentId': input_feed_document_id,
-            **kwargs
+            "feedType": feed_type,
+            "inputFeedDocumentId": input_feed_document_id,
+            **kwargs,
         }
-        return self._request(kwargs.pop('path'), data=data)
+        return self._request(kwargs.pop("path"), data=data)
 
-    @sp_endpoint('/feeds/2021-06-30/feeds/{}', method='DELETE')
+    @sp_endpoint("/feeds/2021-06-30/feeds/{}", method="DELETE")
     def cancel_feed(self, feedId, **kwargs) -> ApiResponse:
         """
         cancel_feed(self, feedId, **kwargs) -> ApiResponse
@@ -126,9 +133,9 @@ class Feeds(Client):
             ApiResponse:
         """
 
-        return self._request(fill_query_params(kwargs.pop('path'), feedId), data=kwargs)
+        return self._request(fill_query_params(kwargs.pop("path"), feedId), data=kwargs)
 
-    @sp_endpoint('/feeds/2021-06-30/feeds/{}', method='GET')
+    @sp_endpoint("/feeds/2021-06-30/feeds/{}", method="GET")
     def get_feed(self, feedId, **kwargs) -> ApiResponse:
         """
         get_feed(self, feedId, **kwargs) -> ApiResponse
@@ -144,9 +151,13 @@ class Feeds(Client):
             ApiResponse:
         """
 
-        return self._request(fill_query_params(kwargs.pop('path'), feedId), params=kwargs, add_marketplace=False)
+        return self._request(
+            fill_query_params(kwargs.pop("path"), feedId),
+            params=kwargs,
+            add_marketplace=False,
+        )
 
-    @sp_endpoint('/feeds/2021-06-30/documents', method='POST')
+    @sp_endpoint("/feeds/2021-06-30/documents", method="POST")
     def create_feed_document(self, file, content_type, **kwargs) -> ApiResponse:
         """
         create_feed_document(self, **kwargs) -> ApiResponse
@@ -164,30 +175,32 @@ class Feeds(Client):
         Returns:
             ApiResponse:
         """
-        data = {
-            'contentType': kwargs.get('contentType', content_type)
-        }
-        response = self._request(kwargs.get('path'), data={**data, **kwargs})
+        data = {"contentType": kwargs.get("contentType", content_type)}
+        response = self._request(kwargs.get("path"), data={**data, **kwargs})
 
-        if(file is None):
+        if file is None:
             return response
 
         upload_data = file.read()
         try:
-            upload_data = upload_data.encode('iso-8859-1')
+            upload_data = upload_data.encode("iso-8859-1")
         except AttributeError:
             pass
-        upload = requests.put(
-            response.payload.get('url'),
-            data=upload_data,
-            headers={'Content-Type': content_type}
-        )
+        with httpx.Client() as client:
+            upload = client.put(
+                response.payload.get("url"),
+                content=upload_data,
+                headers={"Content-Type": content_type},
+            )
         if 200 <= upload.status_code < 300:
             return response
         from sp_api.base.exceptions import SellingApiException
-        raise SellingApiException(headers=upload.headers, error=upload.json().get('errors'))
 
-    @sp_endpoint('/feeds/2021-06-30/documents/{}', method='GET')
+        raise SellingApiException(
+            headers=upload.headers, error=upload.json().get("errors")
+        )
+
+    @sp_endpoint("/feeds/2021-06-30/documents/{}", method="GET")
     def get_feed_document(self, feedDocumentId, **kwargs) -> str:
         """
         get_feed_document(self, feedDocumentId, **kwargs) -> ApiResponse
@@ -207,7 +220,7 @@ class Feeds(Client):
 
         return self.get_feed_result_document(feedDocumentId)
 
-    @sp_endpoint('/feeds/2021-06-30/documents/{}', method='GET')
+    @sp_endpoint("/feeds/2021-06-30/documents/{}", method="GET")
     def get_feed_result_document(self, feedDocumentId, **kwargs) -> str:
         """
         get_feed_result_document(self, feedDocumentId, **kwargs) -> str
@@ -223,17 +236,25 @@ class Feeds(Client):
         Returns:
             str:
         """
-        response = self._request(fill_query_params(kwargs.pop('path'), feedDocumentId), params=kwargs,
-                                 add_marketplace=False)
-        url = response.payload.get('url')
-        doc_response = requests.get(url)
-
-        encoding = doc_response.encoding if doc_response and doc_response.encoding else 'iso-8859-1'
-        if encoding.lower() == 'windows-31j':
-            encoding = 'cp932'
+        response = self._request(
+            fill_query_params(kwargs.pop("path"), feedDocumentId),
+            params=kwargs,
+            add_marketplace=False,
+        )
+        url = response.payload.get("url")
+        with httpx.Client() as client:
+            doc_response = client.get(url)
+
+        encoding = (
+            doc_response.encoding
+            if doc_response and doc_response.encoding
+            else "iso-8859-1"
+        )
+        if encoding.lower() == "windows-31j":
+            encoding = "cp932"
 
         content = doc_response.content
-        if 'compressionAlgorithm' in response.payload:
+        if "compressionAlgorithm" in response.payload:
             try:
                 return zlib.decompress(bytearray(content), 15 + 32).decode(encoding)
             except Exception:

sp_api/api/finances/finances.py

@@ -1,10 +1,23 @@
+import enum
+
 from sp_api.base import Client, Marketplaces, ApiResponse
 from sp_api.base import sp_endpoint, fill_query_params
 
+class FinancesVersion(str, enum.Enum):
+    V_0 = "v0"
+    V_2024_06_19 = "2024-06-19"
+    LATEST = "2024-06-19"
+
 
 class Finances(Client):
+    version: FinancesVersion = FinancesVersion.V_0
+
+    def __init__(self, *args, **kwargs):
+        if "version" in kwargs:
+            self.version = kwargs.get("version", FinancesVersion.V_0)
+        super().__init__(*args, **{**kwargs, "version": self.version})
 
-    @sp_endpoint('/finances/v0/orders/{}/financialEvents')
+    @sp_endpoint("/finances/<version>/orders/{}/financialEvents")
     def get_financial_events_for_order(self, order_id, **kwargs) -> ApiResponse:
         """
         get_financial_events_for_order(self, order_id, **kwargs) -> ApiResponse
@@ -21,9 +34,11 @@ class Finances(Client):
         Returns:
 
         """
-        return self._request(fill_query_params(kwargs.pop('path'), order_id), params={**kwargs})
+        return self._request(
+            fill_query_params(kwargs.pop("path"), order_id), params={**kwargs}
+        )
 
-    @sp_endpoint('/finances/v0/financialEvents')
+    @sp_endpoint("/finances/<version>/financialEvents")
     def list_financial_events(self, **kwargs) -> ApiResponse:
         """
         list_financial_events(self, **kwargs) -> ApiResponse:
@@ -35,10 +50,12 @@ class Finances(Client):
         Returns:
 
         """
-        return self._request(fill_query_params(kwargs.pop('path')), params={**kwargs})
+        return self._request(fill_query_params(kwargs.pop("path")), params={**kwargs})
 
-    @sp_endpoint('/finances/v0/financialEventGroups/{}/financialEvents')
-    def list_financial_events_by_group_id(self, event_group_id,  **kwargs) -> ApiResponse:
+    @sp_endpoint("/finances/<version>/financialEventGroups/{}/financialEvents")
+    def list_financial_events_by_group_id(
+        self, event_group_id, **kwargs
+    ) -> ApiResponse:
         """
         list_financial_events_by_groupid(self, event_group_id,  **kwargs) -> ApiResponse:
 
@@ -50,9 +67,11 @@ class Finances(Client):
         Returns:
 
         """
-        return self._request(fill_query_params(kwargs.pop('path'), event_group_id), params={**kwargs})
+        return self._request(
+            fill_query_params(kwargs.pop("path"), event_group_id), params={**kwargs}
+        )
 
-    @sp_endpoint('/finances/v0/financialEventGroups')
+    @sp_endpoint("/finances/<version>/financialEventGroups")
     def list_financial_event_groups(self, **kwargs) -> ApiResponse:
         """
         list_financial_event_groups(self, **kwargs) -> ApiResponse:
@@ -64,5 +83,17 @@ class Finances(Client):
         Returns:
 
         """
-        return self._request(kwargs.pop('path'), params={**kwargs})
+        return self._request(kwargs.pop("path"), params={**kwargs})
+
+    @sp_endpoint("/finances/<version>/transactions")
+    def list_transactions(self, **kwargs) -> ApiResponse:
+        """
+        list_transactions(self, **kwargs) -> ApiResponse:
+
+        Args:
+            **kwargs:
+
+        Returns: ApiResponse
+        """
 
+        return self._request(kwargs.pop("path"), params={**kwargs})