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

sp_api/api/__init__.py

@@ -1,4 +1,7 @@
 from .finances.finances import Finances, FinancesVersion
+from .finances.finances_2024_06_01 import FinancesV20240601
+from .finances.finances_2024_06_19 import FinancesV20240619
+from .finances.finances_v0 import FinancesV0
 from .notifications.notifications import Notifications
 from .orders.orders import Orders, OrdersVersion
 from .orders.orders_2026_01_01 import OrdersV20260101
@@ -8,22 +11,57 @@ from .sellers.sellers import Sellers
 from .reports.reports import Reports
 from .reports.reports import Reports as ReportsV2
 
-from .products.products import Products
+from .products.products import Products, ProductsVersion
+from .products.products_2022_05_01 import ProductsV20220501
+from .products.products_v0 import ProductsV0
 from .sales.sales import Sales
 from .catalog.catalog import Catalog
-from .feeds.feeds import Feeds
+from .feeds.feeds import Feeds, FeedsVersion
 from .feeds.feeds import Feeds as FeedsV2
+from .feeds.feeds_2021_06_30 import FeedsV20210630
 
 from .inventories.inventories import Inventories
 from .fulfillment_inbound.fulfillment_inbound import (
     FulfillmentInbound,
     FulfillmentInboundVersion,
 )
+from .fulfillment_inbound.fulfillment_inbound_2024_03_20 import (
+    FulfillmentInboundV20240320,
+)
+from .fulfillment_inbound.fulfillment_inbound_v0 import FulfillmentInboundV0
 from .upload.upload import Upload
 from .messaging.messaging import Messaging
 from .merchant_fulfillment.merchant_fulfillment import MerchantFulfillment
 
 ##### DO NOT DELETE ########## INSERT IMPORT HERE #######
+from .delivery_by_amazon.delivery_by_amazon import (
+    DeliveryByAmazon,
+    DeliveryByAmazonVersion,
+)
+from .delivery_by_amazon.delivery_by_amazon_2022_07_01 import DeliveryByAmazonV20220701
+
+from .invoices.invoices import Invoices, InvoicesVersion
+from .invoices.invoices_2024_06_19 import InvoicesV20240619
+
+from .seller_wallet.seller_wallet import SellerWallet, SellerWalletVersion
+from .seller_wallet.seller_wallet_2024_03_01 import SellerWalletV20240301
+
+from .shipment_invoicing.shipment_invoicing import (
+    ShipmentInvoicing,
+    ShipmentInvoicingVersion,
+)
+from .shipment_invoicing.shipment_invoicing_v0 import ShipmentInvoicingV0
+
+from .vehicles.vehicles import Vehicles, VehiclesVersion
+from .vehicles.vehicles_2024_11_01 import VehiclesV20241101
+
+from .vendor_direct_fulfillment_sandbox_test_data.vendor_direct_fulfillment_sandbox_test_data import (
+    VendorDirectFulfillmentSandboxTestData,
+    VendorDirectFulfillmentSandboxTestDataVersion,
+)
+from .vendor_direct_fulfillment_sandbox_test_data.vendor_direct_fulfillment_sandbox_test_data_2021_10_28 import (
+    VendorDirectFulfillmentSandboxTestDataV20211028,
+)
 from .application_integrations.application_integrations import ApplicationIntegrations
 
 from .easy_ship.easy_ship import EasyShip
@@ -35,10 +73,14 @@ from .listings_restrictions.listings_restrictions import ListingsRestrictions
 from .messaging.messaging import Messaging
 
 from .catalog_items.catalog_items import CatalogItems, CatalogItemsVersion
+from .catalog_items.catalog_items_2020_12_01 import CatalogItemsV20201201
+from .catalog_items.catalog_items_2022_04_01 import CatalogItemsV20220401
 
 from .product_type_definitions.product_type_definitions import ProductTypeDefinitions
 
-from .listings_items.listings_items import ListingsItems
+from .listings_items.listings_items import ListingsItems, ListingsItemsVersion
+from .listings_items.listings_items_2020_09_01 import ListingsItemsV20200901
+from .listings_items.listings_items_2021_08_01 import ListingsItemsV20210801
 
 from .vendor_transaction_status.vendor_transaction_status import VendorTransactionStatus
 
@@ -50,10 +92,24 @@ from .vendor_invoices.vendor_invoices import VendorInvoices
 
 from .vendor_direct_fulfillment_transactions.vendor_direct_fulfillment_transactions import (
     VendorDirectFulfillmentTransactions,
+    VendorDirectFulfillmentTransactionsVersion,
+)
+from .vendor_direct_fulfillment_transactions.vendor_direct_fulfillment_transactions_2021_12_28 import (
+    VendorDirectFulfillmentTransactionsV20211228,
+)
+from .vendor_direct_fulfillment_transactions.vendor_direct_fulfillment_transactions_v1 import (
+    VendorDirectFulfillmentTransactionsV1,
 )
 
 from .vendor_direct_fulfillment_shipping.vendor_direct_fulfillment_shipping import (
     VendorDirectFulfillmentShipping,
+    VendorDirectFulfillmentShippingVersion,
+)
+from .vendor_direct_fulfillment_shipping.vendor_direct_fulfillment_shipping_2021_12_28 import (
+    VendorDirectFulfillmentShippingV20211228,
+)
+from .vendor_direct_fulfillment_shipping.vendor_direct_fulfillment_shipping_v1 import (
+    VendorDirectFulfillmentShippingV1,
 )
 
 from .vendor_direct_fulfillment_payments.vendor_direct_fulfillment_payments import (
@@ -62,6 +118,13 @@ from .vendor_direct_fulfillment_payments.vendor_direct_fulfillment_payments impo
 
 from .vendor_direct_fulfillment_orders.vendor_direct_fulfillment_orders import (
     VendorDirectFulfillmentOrders,
+    VendorDirectFulfillmentOrdersVersion,
+)
+from .vendor_direct_fulfillment_orders.vendor_direct_fulfillment_orders_2021_12_28 import (
+    VendorDirectFulfillmentOrdersV20211228,
+)
+from .vendor_direct_fulfillment_orders.vendor_direct_fulfillment_orders_v1 import (
+    VendorDirectFulfillmentOrdersV1,
 )
 
 from .vendor_direct_fulfillment_inventory.vendor_direct_fulfillment_inventory import (
@@ -72,7 +135,9 @@ from .tokens.tokens import Tokens
 
 from .solicitations.solicitations import Solicitations
 
-from .shipping.shipping import Shipping
+from .shipping.shipping import Shipping, ShippingVersion
+from .shipping.shipping_v1 import ShippingV1
+from .shipping.shipping_v2 import ShippingV2
 
 from .services.services import Services
 
@@ -98,12 +163,48 @@ from .amazon_warehousing_and_distribu.amazon_warehousing_and_distribu import (
     AmazonWarehousingAndDistribution,
     AmazonWarehousingAndDistributionVersion,
 )
+from .amazon_warehousing_and_distribu.amazon_warehousing_and_distribu_2024_05_09 import (
+    AmazonWarehousingAndDistributionV20240509,
+)
 
 from .external_fulfillment.external_fulfillment import ExternalFulfillment
+from .external_fulfillment.inventory import (
+    ExternalFulfillmentInventory,
+    ExternalFulfillmentInventoryVersion,
+)
+from .external_fulfillment.inventory_2021_01_06 import (
+    ExternalFulfillmentInventoryV20210106,
+)
+from .external_fulfillment.inventory_2024_09_11 import (
+    ExternalFulfillmentInventoryV20240911,
+)
+from .external_fulfillment.returns import (
+    ExternalFulfillmentReturns,
+    ExternalFulfillmentReturnsVersion,
+)
+from .external_fulfillment.returns_2021_08_19 import (
+    ExternalFulfillmentReturnsV20210819,
+)
+from .external_fulfillment.returns_2024_09_11 import (
+    ExternalFulfillmentReturnsV20240911,
+)
+from .external_fulfillment.shipping import (
+    ExternalFulfillmentShipping,
+    ExternalFulfillmentShippingVersion,
+)
+from .external_fulfillment.shipping_2021_01_06 import (
+    ExternalFulfillmentShippingV20210106,
+)
+from .external_fulfillment.shipping_2024_09_11 import (
+    ExternalFulfillmentShippingV20240911,
+)
 
 __all__ = [
     "Sales",
     "Products",
+    "ProductsVersion",
+    "ProductsV0",
+    "ProductsV20220501",
     "Reports",
     "Orders",
     "OrdersVersion",
@@ -113,16 +214,51 @@ __all__ = [
     "Notifications",
     "ProductFees",
     "Finances",
+    "FinancesV0",
+    "FinancesV20240601",
+    "FinancesV20240619",
     "Catalog",
     "Feeds",
     "Inventories",
     "FulfillmentInbound",
+    "FulfillmentInboundV0",
+    "FulfillmentInboundV20240320",
     "Upload",
     "Messaging",
     "FulfillmentInbound",
     "MerchantFulfillment",
     ##### DO NOT DELETE ########## INSERT TITLE HERE #######
+    "DeliveryByAmazon",
+    "DeliveryByAmazonVersion",
+    "DeliveryByAmazonV20220701",
+    "Invoices",
+    "InvoicesVersion",
+    "InvoicesV20240619",
+    "SellerWallet",
+    "SellerWalletVersion",
+    "SellerWalletV20240301",
+    "ShipmentInvoicing",
+    "ShipmentInvoicingVersion",
+    "ShipmentInvoicingV0",
+    "Vehicles",
+    "VehiclesVersion",
+    "VehiclesV20241101",
+    "VendorDirectFulfillmentSandboxTestData",
+    "VendorDirectFulfillmentSandboxTestDataVersion",
+    "VendorDirectFulfillmentSandboxTestDataV20211028",
     "ExternalFulfillment",
+    "ExternalFulfillmentInventory",
+    "ExternalFulfillmentInventoryVersion",
+    "ExternalFulfillmentInventoryV20210106",
+    "ExternalFulfillmentInventoryV20240911",
+    "ExternalFulfillmentReturns",
+    "ExternalFulfillmentReturnsVersion",
+    "ExternalFulfillmentReturnsV20210819",
+    "ExternalFulfillmentReturnsV20240911",
+    "ExternalFulfillmentShipping",
+    "ExternalFulfillmentShippingVersion",
+    "ExternalFulfillmentShippingV20210106",
+    "ExternalFulfillmentShippingV20240911",
     "ApplicationIntegrations",
     "CustomerFeedback",
     "FulfillmentInbound",
@@ -137,24 +273,43 @@ __all__ = [
     "AmazonWarehousingAndDistributionVersion",
     "FulfillmentInboundVersion",
     "Feeds",
+    "FeedsVersion",
+    "FeedsV20210630",
     "FeedsV2",
     "ReportsV2",
     "Messaging",
     "CatalogItems",
+    "CatalogItemsV20201201",
+    "CatalogItemsV20220401",
     "ProductTypeDefinitions",
     "ListingsItems",
+    "ListingsItemsVersion",
+    "ListingsItemsV20200901",
+    "ListingsItemsV20210801",
     "VendorTransactionStatus",
     "VendorShipments",
     "VendorOrders",
     "VendorInvoices",
     "VendorDirectFulfillmentTransactions",
+    "VendorDirectFulfillmentTransactionsVersion",
+    "VendorDirectFulfillmentTransactionsV1",
+    "VendorDirectFulfillmentTransactionsV20211228",
     "VendorDirectFulfillmentShipping",
+    "VendorDirectFulfillmentShippingVersion",
+    "VendorDirectFulfillmentShippingV1",
+    "VendorDirectFulfillmentShippingV20211228",
     "VendorDirectFulfillmentPayments",
     "VendorDirectFulfillmentOrders",
+    "VendorDirectFulfillmentOrdersVersion",
+    "VendorDirectFulfillmentOrdersV1",
+    "VendorDirectFulfillmentOrdersV20211228",
     "VendorDirectFulfillmentInventory",
     "Tokens",
     "Solicitations",
     "Shipping",
+    "ShippingVersion",
+    "ShippingV1",
+    "ShippingV2",
     "Services",
     "FbaSmallAndLight",
     "FbaInboundEligibility",
@@ -166,4 +321,5 @@ __all__ = [
     "DataKiosk",
     "ApplicationManagement",
     "AmazonWarehousingAndDistribution",
+    "AmazonWarehousingAndDistributionV20240509",
 ]

sp_api/api/amazon_warehousing_and_distribu/amazon_warehousing_and_distribu.py

@@ -1,7 +1,14 @@
+from __future__ import annotations
+
 import enum
-import urllib.parse
+from typing import Any, Literal, TYPE_CHECKING, overload
+from sp_api.util.versioned_client import VersionedClientMeta
+
+from sp_api.base import Client
 
-from sp_api.base import Client, sp_endpoint, fill_query_params, ApiResponse
+from .amazon_warehousing_and_distribu_2024_05_09 import (
+    AmazonWarehousingAndDistributionV20240509,
+)
 
 
 class AmazonWarehousingAndDistributionVersion(str, enum.Enum):
@@ -9,121 +16,89 @@ class AmazonWarehousingAndDistributionVersion(str, enum.Enum):
     LATEST = "2024-05-09"
 
 
-class AmazonWarehousingAndDistribution(Client):
-    """
-    AmazonWarehousingAndDistribu SP-API Client
-    :link:
-
-    The Selling Partner API for Amazon Warehousing and Distribution (AWD).
-    """
-
-    version: AmazonWarehousingAndDistributionVersion = (
-        AmazonWarehousingAndDistributionVersion.V_2024_05_09
-    )
-
-    def __init__(self, *args, **kwargs):
-        if "version" in kwargs:
-            self.version = kwargs.get(
-                "version", AmazonWarehousingAndDistributionVersion.V_2024_05_09
-            )
-        super().__init__(*args, **{**kwargs, "version": self.version})
-
-    @sp_endpoint("/awd/<version>/inboundShipments/{}", method="GET")
-    def get_inbound_shipment(self, shipmentId, **kwargs) -> ApiResponse:
-        """
-                get_inbound_shipment(self, shipmentId, **kwargs) -> ApiResponse
-
-                Retrieves an AWD inbound shipment.
-
-        **Usage Plan:**
-
-        | Rate (requests per second) | Burst |
-        | ---- | ---- |
-        | 2 | 2 |
-
-        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, refer to [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)
-
-                Args:
-
-                    shipmentId:string | * REQUIRED ID for the shipment. A shipment contains the cases being inbounded.
-
-
-                Returns:
-                    ApiResponse:
-        """
-
-        return self._request(
-            fill_query_params(kwargs.pop("path"), shipmentId), params=kwargs
-        )
-
-    @sp_endpoint("/awd/<version>/inboundShipments", method="GET")
-    def list_inbound_shipments(self, **kwargs) -> ApiResponse:
-        """
-                list_inbound_shipments(self, **kwargs) -> ApiResponse
-
-                Retrieves a summary for all the inbound AWD shipments associated with a merchant, with the ability to apply optional filters.
+if TYPE_CHECKING:
 
-        **Usage Plan:**
+    class _AmazonWarehousingAndDistributionMeta(VersionedClientMeta):
+        @overload
+        def __call__(
+            cls,
+            *args: Any,
+            version: Literal[
+                AmazonWarehousingAndDistributionVersion.V_2024_05_09,
+                AmazonWarehousingAndDistributionVersion.LATEST,
+                "2024-05-09",
+            ],
+            **kwargs: Any,
+        ) -> AmazonWarehousingAndDistributionV20240509: ...
 
-        | Rate (requests per second) | Burst |
-        | ---- | ---- |
-        | 1 | 1 |
+        @overload
+        def __call__(
+            cls,
+            *args: Any,
+            version: None = None,
+            **kwargs: Any,
+        ) -> AmazonWarehousingAndDistributionV20240509: ...
 
-        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, refer to [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).
+        @overload
+        def __call__(
+            cls,
+            *args: Any,
+            version: str | AmazonWarehousingAndDistributionVersion,
+            **kwargs: Any,
+        ) -> Client: ...
 
-                Args:
 
-                    key sortBy:string |  Field to sort results by. Required if `sortOrder` is provided.
+else:
+    _AmazonWarehousingAndDistributionMeta = VersionedClientMeta
 
-                    key sortOrder:string |  Sort the response in `ASCENDING` or `DESCENDING` order.
 
-                    key shipmentStatus:string |  Filter by inbound shipment status.
+class AmazonWarehousingAndDistribution(
+    Client, metaclass=_AmazonWarehousingAndDistributionMeta
+):
+    """Amazon Warehousing and Distribution API client.
 
-                    key updatedAfter:string |  List the inbound shipments that were updated after a certain time (inclusive). The date must be in <a href='https://developer-docs.amazon.com/sp-api/docs/iso-8601'>ISO 8601</a> format.
+    This class dispatches to a versioned Amazon Warehousing and Distribution API client.
 
-                    key updatedBefore:string |  List the inbound shipments that were updated before a certain time (inclusive). The date must be in <a href='https://developer-docs.amazon.com/sp-api/docs/iso-8601'>ISO 8601</a> format.
-
-                    key maxResults:integer |  Maximum number of results to return.
-
-                    key nextToken:string |  Token to retrieve the next set of paginated results.
-
-
-                Returns:
-                    ApiResponse:
-        """
-
-        return self._request(kwargs.pop("path"), params=kwargs)
-
-    @sp_endpoint("/awd/<version>/inventory", method="GET")
-    def list_inventory(self, **kwargs) -> ApiResponse:
-        """
-                list_inventory(self, **kwargs) -> ApiResponse
-
-                Lists AWD inventory associated with a merchant with the ability to apply optional filters.
-
-        **Usage Plan:**
-
-        | Rate (requests per second) | Burst |
-        | ---- | ---- |
-        | 2 | 2 |
-
-        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, refer to [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).
-
-                Args:
-
-                    key sku:string |  Filter by seller or merchant SKU for the item.
-
-                    key sortOrder:string |  Sort the response in `ASCENDING` or `DESCENDING` order.
-
-                    key details:string |  Set to `SHOW` to return summaries with additional inventory details. Defaults to `HIDE,` which returns only inventory summary totals.
-
-                    key nextToken:string |  Token to retrieve the next set of paginated results.
-
-                    key maxResults:integer |  Maximum number of results to return.
-
-
-                Returns:
-                    ApiResponse:
-        """
+    If you do not pass a version, the constructor returns the oldest supported implementation ("2024-05-09").
+    """
 
-        return self._request(kwargs.pop("path"), params=kwargs)
+    if TYPE_CHECKING:
+        @overload
+        def __new__(
+            cls,
+            *args: Any,
+            version: Literal[
+                AmazonWarehousingAndDistributionVersion.V_2024_05_09,
+                AmazonWarehousingAndDistributionVersion.LATEST,
+                "2024-05-09",
+            ],
+            **kwargs: Any,
+        ) -> AmazonWarehousingAndDistributionV20240509: ...
+
+        @overload
+        def __new__(
+            cls,
+            *args: Any,
+            version: None = None,
+            **kwargs: Any,
+        ) -> AmazonWarehousingAndDistributionV20240509: ...
+
+        @overload
+        def __new__(
+            cls,
+            *args: Any,
+            version: str | AmazonWarehousingAndDistributionVersion,
+            **kwargs: Any,
+        ) -> Client: ...
+
+    _DISPATCH = True
+
+    _DEFAULT_VERSION = "2024-05-09"
+
+    _VERSION_MAP = {
+        "2024-05-09": AmazonWarehousingAndDistributionV20240509,
+    }
+
+    _VERSION_ALIASES = {
+        "2024-05-09": "2024-05-09",
+    }