python-amazon-sp-api 2.0.8__tar.gz → 2.0.9__tar.gz

{python_amazon_sp_api-2.0.8/python_amazon_sp_api.egg-info → python_amazon_sp_api-2.0.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-amazon-sp-api
-Version: 2.0.8
+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.8 → python_amazon_sp_api-2.0.9/python_amazon_sp_api.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-amazon-sp-api
-Version: 2.0.8
+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.8 → python_amazon_sp_api-2.0.9}/python_amazon_sp_api.egg-info/SOURCES.txt

@@ -59,6 +59,7 @@ sp_api/api/notifications/__init__.py
 sp_api/api/notifications/notifications.py
 sp_api/api/orders/__init__.py
 sp_api/api/orders/orders.py
+sp_api/api/orders/orders_2026_01_01.py
 sp_api/api/product_fees/__init__.py
 sp_api/api/product_fees/product_fees.py
 sp_api/api/product_type_definitions/__init__.py
@@ -157,6 +158,7 @@ sp_api/asyncio/api/notifications/__init__.py
 sp_api/asyncio/api/notifications/notifications.py
 sp_api/asyncio/api/orders/__init__.py
 sp_api/asyncio/api/orders/orders.py
+sp_api/asyncio/api/orders/orders_2026_01_01.py
 sp_api/asyncio/api/overrides/__init__.py
 sp_api/asyncio/api/product_fees/__init__.py
 sp_api/asyncio/api/product_fees/product_fees.py

python_amazon_sp_api-2.0.9/sp_api/__version__.py

@@ -0,0 +1 @@
+__version__ = '2.0.9'

{python_amazon_sp_api-2.0.8/sp_api/asyncio → python_amazon_sp_api-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",

{python_amazon_sp_api-2.0.8 → python_amazon_sp_api-2.0.9}/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
+

python_amazon_sp_api-2.0.9/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,
+        )

{python_amazon_sp_api-2.0.8/sp_api → python_amazon_sp_api-2.0.9/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",

{python_amazon_sp_api-2.0.8 → python_amazon_sp_api-2.0.9}/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
+

python_amazon_sp_api-2.0.9/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,
+        )

python_amazon_sp_api-2.0.8/sp_api/__version__.py

@@ -1 +0,0 @@
-__version__ = '2.0.8'