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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-amazon-sp-api
-Version: 2.0.9
+Version: 2.0.11
 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.9.dist-info → python_amazon_sp_api-2.0.11.dist-info}/RECORD

@@ -1,8 +1,8 @@
-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
+python_amazon_sp_api-2.0.11.data/scripts/make_endpoint,sha256=QWcwG6z4RWFJlzj4-xyHJymjObyKtwkvWFRq8T18iG0,8568
+python_amazon_sp_api-2.0.11.dist-info/licenses/LICENSE,sha256=nbzomPIVo1PVl5bpGAntofsYAF7ZQ2UhzOtKgf7IiNw,1071
 sp_api/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-sp_api/__version__.py,sha256=YHfSoqxCUyNphrTJsW3Ed3e2IVM5_H1IYKii1J5IND4,22
-sp_api/api/__init__.py,sha256=VFMbK4ipsL8w0Lv23BM_KsGtEnssBrxc6xXdutegVzw,4860
+sp_api/__version__.py,sha256=kYhLv18j-O34kNxw6Eplm19f_daEvrswrqeZfkVEPRQ,23
+sp_api/api/__init__.py,sha256=cNQXUvw1dzI0GNP9rKo28LgCsqp6OQ5pswKa2Y4ZXTo,4915
 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,8 +50,9 @@ 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=EAezN8gY6me-fzSwVnn0-vvs-pPD1hkn7RAU1JgrHu8,14562
-sp_api/api/orders/orders_2026_01_01.py,sha256=bmFRS73z2PJaCSk9yvEPtGJA_8QQJu7BEvGP4c8ReLw,1912
+sp_api/api/orders/orders.py,sha256=PzIQ8iYyvre0S-g1OR2SLSeKSGlR83MDbot5MsNpfYI,4275
+sp_api/api/orders/orders_2026_01_01.py,sha256=ymPiKTcfdWKjzR9K2kubb14XK8kqG-i9uZxxqN5ZOfk,1933
+sp_api/api/orders/orders_v0.py,sha256=0JSAVdEkkF7VqDO7NABHzEjeGG3E1j65J3KrPaBK5fY,13073
 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
@@ -99,7 +100,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=VFMbK4ipsL8w0Lv23BM_KsGtEnssBrxc6xXdutegVzw,4860
+sp_api/asyncio/api/__init__.py,sha256=cNQXUvw1dzI0GNP9rKo28LgCsqp6OQ5pswKa2Y4ZXTo,4915
 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
@@ -149,8 +150,9 @@ 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=BpsWEabvgxeyye7b-jaTuSAL9_0WbBIsjSlmGEZxMI8,14733
-sp_api/asyncio/api/orders/orders_2026_01_01.py,sha256=ZgIPCILgvvmNaXMhDW77grKD2C1f98p2rJhQi9mnfXg,1473
+sp_api/asyncio/api/orders/orders.py,sha256=wGmMnA6lWNlV9YTL7OYxU8VnKA4KpOAF1fVnRIN4Vac,4343
+sp_api/asyncio/api/orders/orders_2026_01_01.py,sha256=RtUtdc8t6eAeM0NHmDGqTX1VpH0j3i8bPq1jXGw8MAk,4137
+sp_api/asyncio/api/orders/orders_v0.py,sha256=FLMg899q-ot8b6qwXz11vPj-oZBnWpQL0Pl-x3eeZGo,13243
 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
@@ -247,7 +249,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.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.11.dist-info/METADATA,sha256=A38R7NpcfBA5I88ghl4ZxoluzEu1j7UFZhEye8RxL4I,6969
+python_amazon_sp_api-2.0.11.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+python_amazon_sp_api-2.0.11.dist-info/top_level.txt,sha256=mEzPMFyyy0LmJGY4KFXfh5usUka4eeouIr7-2IAzoE0,7
+python_amazon_sp_api-2.0.11.dist-info/RECORD,,

sp_api/__version__.py

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

sp_api/api/__init__.py

@@ -2,6 +2,7 @@ from .finances.finances import Finances, FinancesVersion
 from .notifications.notifications import Notifications
 from .orders.orders import Orders, OrdersVersion
 from .orders.orders_2026_01_01 import OrdersV20260101
+from .orders.orders_v0 import OrdersV0
 from .product_fees.product_fees import ProductFees
 from .sellers.sellers import Sellers
 from .reports.reports import Reports
@@ -106,6 +107,7 @@ __all__ = [
     "Reports",
     "Orders",
     "OrdersVersion",
+    "OrdersV0",
     "OrdersV20260101",
     "Sellers",
     "Notifications",

sp_api/api/orders/orders.py

@@ -1,13 +1,13 @@
 from __future__ import annotations
 
 import enum
-from typing import Any, Literal, overload
+from typing import Any, Literal, TYPE_CHECKING, 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
-
+from .orders_v0 import OrdersV0
 
 class OrdersVersion(str, enum.Enum):
     V0 = "v0"  # legacy
@@ -15,397 +15,136 @@ class OrdersVersion(str, enum.Enum):
     LATEST = "2026-01-01"
 
 
-class Orders(Client):
-    """Orders API client.
+class _VersionedClientMeta(type):
+    """Metaclass that dispatches construction to a version-specific implementation.
 
-    This class implements the legacy Orders API **v0**.
+    This keeps the call-site ergonomic (`Orders(version=...)`) while allowing a single
+    place to implement the dispatch logic.
 
-    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.
+    Subclasses should define:
+      - `_VERSION_MAP`: mapping of normalized version strings to implementation classes
+      - `_VERSION_ALIASES` (optional): mapping of alias strings to normalized versions
 
-    :link: https://github.com/amzn/selling-partner-api-docs/tree/main/references/orders-api
+    If no version is provided, the default version is used.
     """
 
-    @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:
-        """
-        get_orders(self, **kwargs) -> ApiResponse
-        Returns orders created or updated during the time frame indicated by the specified parameters.
-        You can also apply a range of filtering criteria to narrow the list of orders returned.
-        If NextToken is present, that will be used to retrieve the orders instead of other criteria.
-
-        **Usage Plan:**
-
-        ======================================  ==============
-        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::
-
-                Orders().get_orders(CreatedAfter='TEST_CASE_200', MarketplaceIds=["ATVPDKIKX0DER"])
-
-        Args:
-            key CreatedAfter: date
-            key CreatedBefore: date
-            key LastUpdatedAfter: date
-            key LastUpdatedBefore: date
-            key OrderStatuses: [str]
-            key MarketplaceIds: [str]
-            key FulfillmentChannels: [str]
-            key PaymentMethods: [str]
-            key BuyerEmail: str
-            key SellerOrderId: str
-            key MaxResultsPerPage: int
-            key EasyShipShipmentStatuses: [str]
-            key NextToken: str
-            key AmazonOrderIds: [str]
-            key RestrictedResources: [str]
-
-        Returns:
-            ApiResponse:
-
-
-        """
-        normalize_csv_param(kwargs, "OrderStatuses")
-        normalize_csv_param(kwargs, "MarketplaceIds")
-        normalize_csv_param(kwargs, "FulfillmentChannels")
-        normalize_csv_param(kwargs, "PaymentMethods")
-        normalize_csv_param(kwargs, "AmazonOrderIds")
-
-        if "RestrictedResources" in kwargs:
-            return self._access_restricted(kwargs)
-        return self._request(kwargs.pop("path"), params={**kwargs})
-
-    @sp_endpoint("/orders/v0/orders/{}")
-    def get_order(self, order_id: str, **kwargs) -> ApiResponse:
-        """
-        get_order(self, order_id: str, **kwargs) -> ApiResponse
-        Returns the order indicated by the specified order ID.
-
-        **Usage Plan:**
-
-        ======================================  ==============
-        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::
-
-                Orders().get_order('TEST_CASE_200')
-
-        Args:
-            order_id: str
-            key RestrictedResources: [str]
-            **kwargs:
-
-        Returns:
-            ApiResponse:
-
-
-        """
-        if "RestrictedResources" in kwargs:
-            kwargs.update(
-                {"original_path": fill_query_params(kwargs.get("path"), order_id)}
-            )
-            return self._access_restricted(kwargs)
-        return self._request(
-            fill_query_params(kwargs.pop("path"), order_id),
-            params={**kwargs},
-            add_marketplace=False,
-        )
-
-    @sp_endpoint("/orders/v0/orders/{}/orderItems")
-    def get_order_items(self, order_id: str, **kwargs) -> ApiResponse:
-        """
-        get_order_items(self, order_id: str, **kwargs) -> ApiResponse
-
-        Returns detailed order item information for the order indicated by the specified order ID.
-        If NextToken is provided, it's used to retrieve the next page of order items.
-
-        Note: When an order is in the Pending state (the order has been placed but payment has not been authorized),
-        the getOrderItems operation does not return information about pricing, taxes, shipping charges, gift status or
-        promotions for the order items in the order.
-        After an order leaves the Pending state (this occurs when payment has been authorized) and enters the Unshipped,
-        Partially Shipped, or Shipped state, the getOrderItems operation returns information about pricing, taxes,
-        shipping charges, gift status and promotions for the order items in the order.
-
+    def __call__(cls, *args: Any, **kwargs: Any):
+        version = kwargs.pop("version", None)
 
-        **Usage Plan:**
-
-        ======================================  ==============
-        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::
-
-                Orders().get_order_items('TEST_CASE_200')
-
-        Args:
-            order_id: str
-            key RestrictedResources: [str]
-            **kwargs:
-
-        Returns:
-            ApiResponse:
-
-        """
-        if "RestrictedResources" in kwargs:
-            kwargs.update(
-                {"original_path": fill_query_params(kwargs.get("path"), order_id)}
-            )
-            return self._access_restricted(kwargs)
-        return self._request(
-            fill_query_params(kwargs.pop("path"), order_id), params={**kwargs}
-        )
-
-    @sp_endpoint("/orders/v0/orders/{}/address")
-    def get_order_address(self, order_id, **kwargs) -> ApiResponse:
-        """
-        get_order_address(self, order_id, **kwargs) -> ApiResponse
-
-        Returns the shipping address for the order indicated by the specified order ID.
-
-        :note: To get useful information from this method, you need to have access to PII.
-
-        **Usage Plan:**
+        # Only dispatch for the public front class itself.
+        if cls is Orders:
+            # Backwards-compatible default: if no version is provided, return the
+            # oldest supported implementation.
+            v_raw = version if version is not None else getattr(cls, "_DEFAULT_VERSION", None)
+            if v_raw is None:
+                return super().__call__(*args, **kwargs)
+
+            v_raw = getattr(v_raw, "value", v_raw)
+            v = str(v_raw)
+            aliases: dict[str, str] = getattr(cls, "_VERSION_ALIASES", {})
+            v_norm = aliases.get(v, v)
+
+            impl_map: dict[str, type] = getattr(cls, "_VERSION_MAP", {})
+            impl = impl_map.get(v_norm)
+            if impl is not None:
+                return impl(*args, **kwargs)
+
+            supported = ", ".join(sorted(impl_map.keys()))
+            raise ValueError(f"Unsupported version {v!r}. Supported: {supported}")
+
+        return super().__call__(*args, **kwargs)
+
+
+if TYPE_CHECKING:
+
+    class _OrdersMeta(_VersionedClientMeta):
+        @overload
+        def __call__(
+            self,
+            *args: Any,
+            version: Literal[OrdersVersion.V_2026_01_01, OrdersVersion.LATEST, "2026-01-01"],
+            **kwargs: Any,
+        ) -> OrdersV20260101: ...
+
+        @overload
+        def __call__(
+            self,
+            *args: Any,
+            version: Literal[OrdersVersion.V0, "v0"],
+            **kwargs: Any,
+        ) -> OrdersV0: ...
+
+        @overload
+        def __call__(
+            self,
+            *args: Any,
+            version: None = None,
+            **kwargs: Any,
+        ) -> OrdersV0: ...
+
+        @overload
+        def __call__(
+            self,
+            *args: Any,
+            version: str | OrdersVersion,
+            **kwargs: Any,
+        ) -> Client: ...
+
+
+else:
+    _OrdersMeta = _VersionedClientMeta
+
+class Orders(Client, metaclass=_OrdersMeta):
+    """Orders API client.
 
-        ======================================  ==============
-        Rate (requests per second)               Burst
-        ======================================  ==============
-        1                                       1
-        ======================================  ==============
+    This class dispatches to a versioned Orders API client.
 
-        Examples:
-            Orders().get_order_address('TEST_CASE_200')
+    If you do not pass a version, the constructor returns the oldest supported implementation ("v0").
 
-        Args:
-            order_id: str
-            **kwargs:
-
-        Returns:
-            ApiResponse
-        """
-        return self._request(
-            fill_query_params(kwargs.pop("path"), order_id), params={**kwargs}
-        )
-
-    @sp_endpoint("/orders/v0/orders/{}/buyerInfo")
-    def get_order_buyer_info(self, order_id: str, **kwargs) -> ApiResponse:
-        """
-        get_order_buyer_info(self, order_id: str, **kwargs) -> ApiResponse
-        Returns buyer information for the order indicated by the specified order ID.
-
-        :note: To get useful information from this method, you need to have access to PII.
-
-
-        **Usage Plan:**
-
-        ======================================  ==============
-        Rate (requests per second)               Burst
-        ======================================  ==============
-        1                                       1
-        ======================================  ==============
-
-
-        For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.
-
-        Examples:
-            Orders().get_order_buyer_info('TEST_CASE_200')
-
-        Args:
-            order_id: str
-            **kwargs:
-
-        Returns:
-            GetOrderBuyerInfoResponse:
-
-        """
-        return self._request(
-            fill_query_params(kwargs.pop("path"), order_id), params={**kwargs}
-        )
-
-    @sp_endpoint("/orders/v0/orders/{}/orderItems/buyerInfo")
-    def get_order_items_buyer_info(self, order_id: str, **kwargs) -> ApiResponse:
-        """
-        get_order_items_buyer_info(self, order_id: str, **kwargs) -> ApiResponse
-
-        Returns buyer information in the order items of the order indicated by the specified order ID.
-
-        **Usage Plan:**
-
-        ======================================  ==============
-        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::
-
-                Orders().get_order_items_buyer_info('TEST_CASE_200')
-
-        Args:
-            order_id: str
-            key NextToken: str | retrieve data by next token
-
-        Returns:
-            ApiResponse
-        """
-        return self._request(
-            fill_query_params(kwargs.pop("path"), order_id), params=kwargs
-        )
-
-    @sp_endpoint("/orders/v0/orders/{}/shipment", method="POST")
-    def update_shipment_status(self, order_id: str, **kwargs) -> ApiResponse:
-        """
-        update_shipment_status(self, order_id: str, **kwargs) -> ApiResponse
-        Update the shipment status.
-        **Usage Plan:**
-        ======================================  ==============
-        Rate (requests per second)               Burst
-        ======================================  ==============
-        5                                       15
-        ======================================  ==============
-        For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.
-        Examples:
-            literal blocks::
-                Orders().update_shipment_status(
-                    order_id='123-1234567-1234567',
-                    marketplaceId='ATVPDKIKX0DER',
-                    shipmentStatus='ReadyForPickup'
-                )
-        Args:
-            order_id: str
-        Returns:
-            ApiResponse
-        """
-        return self._request(
-            fill_query_params(kwargs.pop("path"), order_id),
-            res_no_data=True,
-            data=kwargs,
-        )
-
-    @sp_endpoint("/orders/v0/orders/{}/shipmentConfirmation", method="POST")
-    def confirm_shipment(self, order_id: str, **kwargs) -> ApiResponse:
-        """
-        confirm_shipment(self, order_id: str, **kwargs) -> ApiResponse
-        Updates the shipment confirmation status for a specified order.
-        **Usage Plan:**
-        ======================================  ==============
-        Rate (requests per second)               Burst
-        ======================================  ==============
-        2                                       10
-        ======================================  ==============
-        For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.
-        Examples:
-            literal blocks::
-                Orders().confirm_shipment(
-                    order_id='123-1234567-1234567',
-                    marketplaceId='ATVPDKIKX0DER',
-                    packageDetail={
-                        'packageReferenceId': '0001',
-                        'carrierCode': 'DHL',
-                        "shippingMethod": 'Paket',
-                        'trackingNumber': '1234567890',
-                        'shipDate': '2023-03-19T12:00:00Z',
-                        'orderItems': [
-                            {
-                                'orderItemId': '123456789',
-                                'quantity': 1
-                            },
-                            {
-                                'orderItemId': '2345678901',
-                                'quantity': 2
-                            },
-                        ]
-                    }
-                )
-        Args:
-            order_id: str
-        Returns:
-            ApiResponse
-        """
-        return self._request(
-            fill_query_params(kwargs.pop("path"), order_id),
-            add_marketplace=False,
-            res_no_data=True,
-            data=kwargs,
-        )
-
-    @sp_endpoint("/tokens/2021-03-01/restrictedDataToken", method="POST")
-    def _get_token(self, **kwargs):
-        data_elements = kwargs.pop("RestrictedResources")
-
-        restricted_resources = [
-            {
-                "method": "GET",
-                "path": kwargs.get("original_path"),
-                "dataElements": data_elements,
-            }
-        ]
-
-        return self._request(
-            kwargs.pop("path"),
-            data={"restrictedResources": restricted_resources, **kwargs},
-        )
-
-    def _access_restricted(self, kwargs):
-        if "original_path" not in kwargs:
-            kwargs.update({"original_path": kwargs["path"]})
-        token = self._get_token(**kwargs).payload
-        self.restricted_data_token = token["restrictedDataToken"]
-        r = self._request(kwargs.pop("original_path"), params={**kwargs})
-        if not self.keep_restricted_data_token:
-            self.restricted_data_token = None
-        return r
+    :link: https://github.com/amzn/selling-partner-api-docs/tree/main/references/orders-api
+    """
 
+    if TYPE_CHECKING:
+        @overload
+        def __new__(
+            cls,
+            *args: Any,
+            version: Literal[OrdersVersion.V_2026_01_01, OrdersVersion.LATEST, "2026-01-01"],
+            **kwargs: Any,
+        ) -> OrdersV20260101: ...
+
+        @overload
+        def __new__(
+            cls,
+            *args: Any,
+            version: Literal[OrdersVersion.V0, "v0"],
+            **kwargs: Any,
+        ) -> OrdersV0: ...
+
+        @overload
+        def __new__(
+            cls,
+            *args: Any,
+            version: None = None,
+            **kwargs: Any,
+        ) -> OrdersV0: ...
+
+        @overload
+        def __new__(
+            cls,
+            *args: Any,
+            version: str | OrdersVersion,
+            **kwargs: Any,
+        ) -> Client: ...
+
+    _DEFAULT_VERSION = "v0"
+
+    _VERSION_MAP = {
+        "v0": OrdersV0,
+        "2026-01-01": OrdersV20260101,
+    }
+
+    _VERSION_ALIASES = {
+        "v0": "v0",
+        "2026-01-01": "2026-01-01",
+    }

sp_api/api/orders/orders_2026_01_01.py

@@ -32,7 +32,7 @@ class OrdersV20260101(Client):
         normalize_csv_param(kwargs, "marketplaceIds")
         normalize_csv_param(kwargs, "fulfilledBy")
         normalize_csv_param(kwargs, "includedData")
-
+        print(kwargs)
         return self._request(kwargs.pop("path"), params={**kwargs})
 
     @sp_endpoint("/orders/2026-01-01/orders/{}")