python-amazon-sp-api 2.0.7__py3-none-any.whl → 2.0.9__py3-none-any.whl

{python_amazon_sp_api-2.0.7.dist-info → python_amazon_sp_api-2.0.9.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-amazon-sp-api
-Version: 2.0.7
+Version: 2.0.9
 Summary: Python wrapper for the Amazon Selling-Partner API
 Home-page: https://github.com/saleweaver/python-amazon-sp-api
 Author: Michael Primke

{python_amazon_sp_api-2.0.7.dist-info → python_amazon_sp_api-2.0.9.dist-info}/RECORD

@@ -1,8 +1,8 @@
-python_amazon_sp_api-2.0.7.data/scripts/make_endpoint,sha256=QWcwG6z4RWFJlzj4-xyHJymjObyKtwkvWFRq8T18iG0,8568
-python_amazon_sp_api-2.0.7.dist-info/licenses/LICENSE,sha256=nbzomPIVo1PVl5bpGAntofsYAF7ZQ2UhzOtKgf7IiNw,1071
+python_amazon_sp_api-2.0.9.data/scripts/make_endpoint,sha256=QWcwG6z4RWFJlzj4-xyHJymjObyKtwkvWFRq8T18iG0,8568
+python_amazon_sp_api-2.0.9.dist-info/licenses/LICENSE,sha256=nbzomPIVo1PVl5bpGAntofsYAF7ZQ2UhzOtKgf7IiNw,1071
 sp_api/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-sp_api/__version__.py,sha256=Eqd_jrp6aA0AOwkbRY6r2MSGXmOOkqUkdUqKDmktZJM,22
-sp_api/api/__init__.py,sha256=QTDz2g_fryNGkGszhytqhI8K3x_ttP7fbXLJ5uRvmj0,4747
+sp_api/__version__.py,sha256=YHfSoqxCUyNphrTJsW3Ed3e2IVM5_H1IYKii1J5IND4,22
+sp_api/api/__init__.py,sha256=VFMbK4ipsL8w0Lv23BM_KsGtEnssBrxc6xXdutegVzw,4860
 sp_api/api/amazon_warehousing_and_distribu/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 sp_api/api/amazon_warehousing_and_distribu/amazon_warehousing_and_distribu.py,sha256=bMBIxIj0eu6Gi6WY3XLdHHYDzNCwz0-9X59Jo9DoqfE,5863
 sp_api/api/aplus_content/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -50,7 +50,8 @@ sp_api/api/messaging/messaging.py,sha256=pb_LWzBiE6RRVR6NTT6AW0uoBsiPMaoE7TJ-uge
 sp_api/api/notifications/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 sp_api/api/notifications/notifications.py,sha256=VbMQcRHlrLuZqx252kDR9n0zX2FVcEUOO0rW-1QJ3Oc,10937
 sp_api/api/orders/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-sp_api/api/orders/orders.py,sha256=TIbhUVnrm1CE7Wobgz3uKmHBpynVmSKzQREshT5fpiw,13227
+sp_api/api/orders/orders.py,sha256=EAezN8gY6me-fzSwVnn0-vvs-pPD1hkn7RAU1JgrHu8,14562
+sp_api/api/orders/orders_2026_01_01.py,sha256=bmFRS73z2PJaCSk9yvEPtGJA_8QQJu7BEvGP4c8ReLw,1912
 sp_api/api/product_fees/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 sp_api/api/product_fees/product_fees.py,sha256=QwIVQKpXLXrc1Z2yQ2miSMizQsvprHVmxvG9vM_5niM,6913
 sp_api/api/product_type_definitions/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -98,7 +99,7 @@ sp_api/api/vendor_shipments/vendor_shipments.py,sha256=EFzVetejcR3RLzH9iOMN_JFFX
 sp_api/api/vendor_transaction_status/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 sp_api/api/vendor_transaction_status/vendor_transaction_status.py,sha256=hHDA4NSaLxuNUBWNpV5_MfPgRSEm3t0A7Yl9MY6pULc,1690
 sp_api/asyncio/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-sp_api/asyncio/api/__init__.py,sha256=QTDz2g_fryNGkGszhytqhI8K3x_ttP7fbXLJ5uRvmj0,4747
+sp_api/asyncio/api/__init__.py,sha256=VFMbK4ipsL8w0Lv23BM_KsGtEnssBrxc6xXdutegVzw,4860
 sp_api/asyncio/api/amazon_warehousing_and_distribu/__init__.py,sha256=euZc6oTWMvMEOl-qcaVlS9QuQ5VC6FcUkF-tWYfbGAY,233
 sp_api/asyncio/api/amazon_warehousing_and_distribu/amazon_warehousing_and_distribu.py,sha256=LDYSQNjGuWdTbfH-9ApC8QY2iRph_wv_Fc6Jv5L2m8k,5947
 sp_api/asyncio/api/aplus_content/__init__.py,sha256=JWgnKrh9Q6eUXogOMDl8ap5si-zjWoPzZGJ_TeJ5rSo,74
@@ -148,7 +149,8 @@ sp_api/asyncio/api/models/__init__.py,sha256=uHFaIn5OjyNVh8VXOqzqnC0ehTmd6fp_SRt
 sp_api/asyncio/api/notifications/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 sp_api/asyncio/api/notifications/notifications.py,sha256=xjg6nQ3Jgvk82TAovreQTneGocXKcY-Jk6flXrz0GhQ,11083
 sp_api/asyncio/api/orders/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-sp_api/asyncio/api/orders/orders.py,sha256=IKns8nkkaYYSekquS6F_JAcLEGboecSXRWUqb0YBp7w,13358
+sp_api/asyncio/api/orders/orders.py,sha256=BpsWEabvgxeyye7b-jaTuSAL9_0WbBIsjSlmGEZxMI8,14733
+sp_api/asyncio/api/orders/orders_2026_01_01.py,sha256=ZgIPCILgvvmNaXMhDW77grKD2C1f98p2rJhQi9mnfXg,1473
 sp_api/asyncio/api/overrides/__init__.py,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
 sp_api/asyncio/api/product_fees/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 sp_api/asyncio/api/product_fees/product_fees.py,sha256=9GIQuoz37_QDmKnCe9wdjyqAhX5-z1n_AaTdvVyt_N8,6998
@@ -245,7 +247,7 @@ sp_api/util/product_fees.py,sha256=uvTct-armJYwkRsDn_2PBNOAD2H3_mfc8NqkFpjXzi4,1
 sp_api/util/products_definitions.py,sha256=TVO1L-vjyzSmL54Xfa0m3K6rVUFaTNsYBjeGnLpscDI,5061
 sp_api/util/report_document.py,sha256=_LxuIJDIb6DTvzobY4qdlQ78ibZi6rwQ1dDK3FMxegs,4682
 sp_api/util/retry.py,sha256=V8SeSeX3Brdou138hNA5HeQkKlHppZcqbZobIDjmBYw,2407
-python_amazon_sp_api-2.0.7.dist-info/METADATA,sha256=cCwizrFOz0V2JCtHcXXCc2bJW03Sw9sjwil4iu9SQUo,6968
-python_amazon_sp_api-2.0.7.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-python_amazon_sp_api-2.0.7.dist-info/top_level.txt,sha256=mEzPMFyyy0LmJGY4KFXfh5usUka4eeouIr7-2IAzoE0,7
-python_amazon_sp_api-2.0.7.dist-info/RECORD,,
+python_amazon_sp_api-2.0.9.dist-info/METADATA,sha256=rT0oMk5R-U6H3w4T6eqTE1l_JxPPRrqnAVyCO0ZrJ7U,6968
+python_amazon_sp_api-2.0.9.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+python_amazon_sp_api-2.0.9.dist-info/top_level.txt,sha256=mEzPMFyyy0LmJGY4KFXfh5usUka4eeouIr7-2IAzoE0,7
+python_amazon_sp_api-2.0.9.dist-info/RECORD,,

{python_amazon_sp_api-2.0.7.dist-info → python_amazon_sp_api-2.0.9.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.9.0)
+Generator: setuptools (80.10.2)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

sp_api/__version__.py

@@ -1 +1 @@
-__version__ = '2.0.7'
+__version__ = '2.0.9'

sp_api/api/__init__.py

@@ -1,6 +1,7 @@
 from .finances.finances import Finances, FinancesVersion
 from .notifications.notifications import Notifications
-from .orders.orders import Orders
+from .orders.orders import Orders, OrdersVersion
+from .orders.orders_2026_01_01 import OrdersV20260101
 from .product_fees.product_fees import ProductFees
 from .sellers.sellers import Sellers
 from .reports.reports import Reports
@@ -104,6 +105,8 @@ __all__ = [
     "Products",
     "Reports",
     "Orders",
+    "OrdersVersion",
+    "OrdersV20260101",
     "Sellers",
     "Notifications",
     "ProductFees",

sp_api/api/orders/orders.py

@@ -1,13 +1,61 @@
-from sp_api.base import sp_endpoint, fill_query_params, ApiResponse, deprecated
-from sp_api.base import Client, Marketplaces
+from __future__ import annotations
+
+import enum
+from typing import Any, Literal, overload
+
+from sp_api.base import ApiResponse, Client, Marketplaces, deprecated, fill_query_params, sp_endpoint
 from sp_api.util import normalize_csv_param
 
+from .orders_2026_01_01 import OrdersV20260101
+
+
+class OrdersVersion(str, enum.Enum):
+    V0 = "v0"  # legacy
+    V_2026_01_01 = "2026-01-01"
+    LATEST = "2026-01-01"
+
 
 class Orders(Client):
-    """
+    """Orders API client.
+
+    This class implements the legacy Orders API **v0**.
+
+    If you pass version "2026-01-01" (or :class:`OrdersVersion.V_2026_01_01`)
+    to the constructor, :meth:`__new__` returns an instance of
+    :class:`~sp_api.api.orders.orders_2026_01_01.OrdersV20260101` instead.
+
     :link: https://github.com/amzn/selling-partner-api-docs/tree/main/references/orders-api
     """
 
+    @overload
+    def __new__(
+        cls,
+        *args: Any,
+        version: Literal[OrdersVersion.V_2026_01_01, "2026-01-01"],
+        **kwargs: Any,
+    ) -> OrdersV20260101: ...
+
+    @overload
+    def __new__(
+        cls,
+        *args: Any,
+        version: str | OrdersVersion | None = None,
+        **kwargs: Any,
+    ) -> "Orders": ...
+
+    def __new__(
+        cls,
+        *args: Any,
+        version: str | OrdersVersion | None = None,
+        **kwargs: Any,
+    ):
+        if cls is Orders:
+            v = version if version is not None else kwargs.get("version")
+            if v in (OrdersVersion.V_2026_01_01, OrdersVersion.LATEST, "2026-01-01"):
+                kwargs.pop("version", None)
+                return OrdersV20260101(*args, **kwargs)
+        return super().__new__(cls)
+
     @sp_endpoint("/orders/v0/orders")
     def get_orders(self, **kwargs) -> ApiResponse:
         """
@@ -360,3 +408,4 @@ class Orders(Client):
         if not self.keep_restricted_data_token:
             self.restricted_data_token = None
         return r
+

sp_api/api/orders/orders_2026_01_01.py

@@ -0,0 +1,54 @@
+from __future__ import annotations
+
+from typing import Any
+
+from sp_api.base import ApiResponse, Client, fill_query_params, sp_endpoint
+from sp_api.util import normalize_csv_param
+
+
+class OrdersV20260101(Client):
+    """Orders API (version 2026-01-01).
+
+    This is a newer Orders API version that uses different endpoints/parameters
+    than the legacy v0 Orders API implemented by :class:`sp_api.api.orders.orders.Orders`.
+
+    Model source:
+    https://github.com/amzn/selling-partner-api-models/blob/main/models/orders-api-model/orders_2026-01-01.json
+    """
+
+    @sp_endpoint("/orders/2026-01-01/orders")
+    def search_orders(self, **kwargs: Any) -> ApiResponse:
+        """Search orders.
+
+        Corresponds to GET /orders/2026-01-01/orders (operationId: searchOrders).
+
+        Notes:
+        - Parameters are lowerCamelCase in this version (e.g. createdAfter).
+        - List parameters can be passed as Python lists; they will be normalized
+          into a comma-delimited string.
+        """
+
+        normalize_csv_param(kwargs, "fulfillmentStatuses")
+        normalize_csv_param(kwargs, "marketplaceIds")
+        normalize_csv_param(kwargs, "fulfilledBy")
+        normalize_csv_param(kwargs, "includedData")
+
+        return self._request(kwargs.pop("path"), params={**kwargs})
+
+    @sp_endpoint("/orders/2026-01-01/orders/{}")
+    def get_order(self, order_id: str, **kwargs: Any) -> ApiResponse:
+        """Get order by orderId.
+
+        Corresponds to GET /orders/2026-01-01/orders/{orderId} (operationId: getOrder).
+
+        Args:
+            order_id: The Amazon order identifier.
+            includedData: Optional list of datasets to include in the response.
+        """
+
+        normalize_csv_param(kwargs, "includedData")
+        return self._request(
+            fill_query_params(kwargs.pop("path"), order_id),
+            params={**kwargs},
+            add_marketplace=False,
+        )

sp_api/asyncio/api/__init__.py

@@ -1,6 +1,7 @@
 from .finances.finances import Finances, FinancesVersion
 from .notifications.notifications import Notifications
-from .orders.orders import Orders
+from .orders.orders import Orders, OrdersVersion
+from .orders.orders_2026_01_01 import OrdersV20260101
 from .product_fees.product_fees import ProductFees
 from .sellers.sellers import Sellers
 from .reports.reports import Reports
@@ -104,6 +105,8 @@ __all__ = [
     "Products",
     "Reports",
     "Orders",
+    "OrdersVersion",
+    "OrdersV20260101",
     "Sellers",
     "Notifications",
     "ProductFees",

sp_api/asyncio/api/orders/orders.py

@@ -1,13 +1,62 @@
-from sp_api.base import sp_endpoint, fill_query_params, ApiResponse, deprecated
+from __future__ import annotations
+
+import enum
+from typing import Any, Literal, overload
+
 from sp_api.asyncio.base import AsyncBaseClient
+from sp_api.base import ApiResponse, deprecated, fill_query_params, sp_endpoint
 from sp_api.util import normalize_csv_param
 
+from .orders_2026_01_01 import OrdersV20260101
+
+
+class OrdersVersion(str, enum.Enum):
+    V0 = "v0"  # legacy
+    V_2026_01_01 = "2026-01-01"
+    LATEST = "2026-01-01"
+
 
 class Orders(AsyncBaseClient):
-    """
+    """Orders API client (async).
+
+    This class implements the legacy Orders API **v0**.
+
+    If you pass version "2026-01-01" (or :class:`OrdersVersion.V_2026_01_01`)
+    to the constructor, :meth:`__new__` returns an instance of
+    :class:`~sp_api.asyncio.api.orders.orders_2026_01_01.OrdersV20260101` instead.
+
     :link: https://github.com/amzn/selling-partner-api-docs/tree/main/references/orders-api
     """
 
+    @overload
+    def __new__(
+        cls,
+        *args: Any,
+        version: Literal[OrdersVersion.V_2026_01_01, "2026-01-01"],
+        **kwargs: Any,
+    ) -> OrdersV20260101: ...
+
+    @overload
+    def __new__(
+        cls,
+        *args: Any,
+        version: str | OrdersVersion | None = None,
+        **kwargs: Any,
+    ) -> "Orders": ...
+
+    def __new__(
+        cls,
+        *args: Any,
+        version: str | OrdersVersion | None = None,
+        **kwargs: Any,
+    ):
+        if cls is Orders:
+            v = version if version is not None else kwargs.get("version")
+            if v in (OrdersVersion.V_2026_01_01, OrdersVersion.LATEST, "2026-01-01"):
+                kwargs.pop("version", None)
+                return OrdersV20260101(*args, **kwargs)
+        return super().__new__(cls)
+
     @sp_endpoint("/orders/v0/orders")
     async def get_orders(self, **kwargs) -> ApiResponse:
         """
@@ -359,4 +408,5 @@ class Orders(AsyncBaseClient):
         r = await self._request(kwargs.pop("original_path"), params={**kwargs})
         if not self.keep_restricted_data_token:
             self.restricted_data_token = None
-        return r
+        return r
+

sp_api/asyncio/api/orders/orders_2026_01_01.py

@@ -0,0 +1,40 @@
+from __future__ import annotations
+
+from typing import Any
+
+from sp_api.asyncio.base import AsyncBaseClient
+from sp_api.base import ApiResponse, fill_query_params, sp_endpoint
+from sp_api.util import normalize_csv_param
+
+
+class OrdersV20260101(AsyncBaseClient):
+    """Orders API (version 2026-01-01) - async client.
+
+    This is a newer Orders API version that uses different endpoints/parameters
+    than the legacy v0 Orders API implemented by :class:`sp_api.asyncio.api.orders.orders.Orders`.
+
+    Model source:
+    https://github.com/amzn/selling-partner-api-models/blob/main/models/orders-api-model/orders_2026-01-01.json
+    """
+
+    @sp_endpoint("/orders/2026-01-01/orders")
+    async def search_orders(self, **kwargs: Any) -> ApiResponse:
+        """Search orders (async)."""
+
+        normalize_csv_param(kwargs, "fulfillmentStatuses")
+        normalize_csv_param(kwargs, "marketplaceIds")
+        normalize_csv_param(kwargs, "fulfilledBy")
+        normalize_csv_param(kwargs, "includedData")
+
+        return await self._request(kwargs.pop("path"), params={**kwargs})
+
+    @sp_endpoint("/orders/2026-01-01/orders/{}")
+    async def get_order(self, order_id: str, **kwargs: Any) -> ApiResponse:
+        """Get order by orderId (async)."""
+
+        normalize_csv_param(kwargs, "includedData")
+        return await self._request(
+            fill_query_params(kwargs.pop("path"), order_id),
+            params={**kwargs},
+            add_marketplace=False,
+        )