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

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):
@@ -34,7 +35,7 @@ class Feeds(Client):
             ApiResponse:
         """
 
-        add_marketplace = not "nextToken" in kwargs
+        add_marketplace = should_add_marketplace(kwargs, "nextToken")
         return self._request(
             kwargs.pop("path"), params=kwargs, add_marketplace=add_marketplace
         )
@@ -185,11 +186,12 @@ class Feeds(Client):
             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
@@ -240,7 +242,8 @@ class Feeds(Client):
             add_marketplace=False,
         )
         url = response.payload.get("url")
-        doc_response = requests.get(url)
+        with httpx.Client() as client:
+            doc_response = client.get(url)
 
         encoding = (
             doc_response.encoding

sp_api/api/fulfillment_inbound/fulfillment_inbound.py

@@ -4,6 +4,7 @@ from sp_api.base import Client, Marketplaces, ApiResponse
 from sp_api.base import sp_endpoint, fill_query_params
 
 import urllib.parse
+from sp_api.util import ensure_csv
 
 
 class FulfillmentInboundVersion(str, enum.Enum):
@@ -197,6 +198,39 @@ class FulfillmentInbound(Client):
             fill_query_params(kwargs.pop("path"), shipment_id), data={**data, **kwargs}
         )
 
+    @sp_endpoint(
+        "/inbound/fba/<version>/inboundPlans/{}/shipments/{}/name", method="PUT"
+    )
+    def update_shipment_name(self, inboundPlanId, shipmentId, **kwargs):
+        """
+                update_shipment_name(self, inboundPlanId, shipmentId, **kwargs) -> ApiResponse
+
+                Updates the name of an existing shipment.
+
+        **Usage Plan:**
+
+        | Rate (requests per second) | Burst |
+        | ---- | ---- |
+        | 2 | 30 |
+
+        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:
+
+                    inboundPlanId:string | * REQUIRED Identifier to an inbound plan.
+
+                    shipmentId:string | * REQUIRED Identifier to a shipment. A shipment contains the boxes and units being inbounded.
+
+                    body: | * REQUIRED {'name': {'description': 'A human-readable name to update the shipment name to.'}, 'type': 'string'}
+
+                Returns:
+                    ApiResponse:
+        """
+        return self._request(
+            fill_query_params(kwargs.pop("path"), inboundPlanId, shipmentId),
+            data=kwargs,
+        )
+
     @sp_endpoint("/fba/inbound/<version>/shipments/{}/preorder")
     def preorder(self, shipment_id, **kwargs):
         """
@@ -456,8 +490,7 @@ class FulfillmentInbound(Client):
         Returns:
             ApiResponse
         """
-        if not isinstance(shipment_id_list, str):
-            shipment_id_list = ",".join(shipment_id_list)
+        shipment_id_list = ensure_csv(shipment_id_list)
         return self.get_shipments(
             QueryType="SHIPMENT", ShipmentIdList=shipment_id_list, **kwargs
         )

sp_api/api/inventories/inventories.py

@@ -1,8 +1,8 @@
-from collections import abc
 import urllib
 
 from sp_api.base import Client, Marketplaces, sp_endpoint, ApiResponse
 from sp_api.base.InventoryEnums import InventoryGranularity
+from sp_api.util import normalize_csv_param
 
 
 class Inventories(Client):
@@ -68,11 +68,6 @@ class Inventories(Client):
                 "granularityId": kwargs.get("granularityId", self.marketplace_id),
             }
         )
-        if (
-            "sellerSkus" in kwargs
-            and isinstance(kwargs.get("sellerSkus"), abc.Iterable)
-            and not isinstance(kwargs.get("sellerSkus"), str)
-        ):
-            kwargs.update({"sellerSkus": ",".join(kwargs.get("sellerSkus"))})
+        normalize_csv_param(kwargs, "sellerSkus")
 
         return self._request(kwargs.pop("path"), params=kwargs)

sp_api/api/listings_items/listings_items.py

@@ -1,5 +1,3 @@
-from collections import abc
-
 from sp_api.base import (
     Client,
     sp_endpoint,
@@ -7,6 +5,7 @@ from sp_api.base import (
     ApiResponse,
     IncludedData,
 )
+from sp_api.util import normalize_included_data
 
 
 class ListingsItems(Client):
@@ -65,17 +64,7 @@ class ListingsItems(Client):
         Returns:
             ApiResponse:
         """
-        if (
-            kwargs.get("includedData")
-            and isinstance(kwargs.get("includedData"), abc.Iterable)
-            and not isinstance(kwargs.get("includedData"), str)
-        ):
-            kwargs["includedData"] = ",".join(
-                [
-                    x.value if isinstance(x, IncludedData) else x
-                    for x in kwargs["includedData"]
-                ]
-            )
+        normalize_included_data(kwargs, enum_cls=IncludedData)
 
         return self._request(
             fill_query_params(kwargs.pop("path"), sellerId, sku), params=kwargs
@@ -101,17 +90,7 @@ class ListingsItems(Client):
         Returns:
             ApiResponse:
         """
-        if (
-            kwargs.get("includedData")
-            and isinstance(kwargs.get("includedData"), abc.Iterable)
-            and not isinstance(kwargs.get("includedData"), str)
-        ):
-            kwargs["includedData"] = ",".join(
-                [
-                    x.value if isinstance(x, IncludedData) else x
-                    for x in kwargs["includedData"]
-                ]
-            )
+        normalize_included_data(kwargs, enum_cls=IncludedData)
 
         return self._request(
             fill_query_params(kwargs.pop("path"), sellerId), params=kwargs

sp_api/api/messaging/messaging.py

@@ -466,3 +466,45 @@ class Messaging(Client):
                 "method": kwargs.pop("method"),
             },
         )
+
+    @sp_endpoint("/messaging/v1/orders/{}/messages/invoice", method="POST")
+    def send_invoice(self, order_id, **kwargs) -> ApiResponse:
+        """
+        send_invoice(self, order_id, **kwargs) -> ApiResponse
+
+        Sends a message providing the buyer an invoice
+
+        **Usage Plan:**
+
+        ======================================  ==============
+        Rate (requests per second)               Burst
+        ======================================  ==============
+        1                                       5
+        ======================================  ==============
+
+        For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.
+
+        Args:
+            order_id:string | * REQUIRED An Amazon order identifier. This specifies the order for which a message is sent.
+            body: {
+              "attachments": [
+                {
+                  "uploadDestinationId": "string",
+                  "fileName": "string"
+                }
+              ]
+            }
+
+
+        Returns:
+            ApiResponse:
+        """
+
+        return self._request(
+            fill_query_params(kwargs.pop("path"), order_id),
+            data=kwargs.pop("body"),
+            params={
+                "marketplaceIds": self.marketplace_id,
+                "method": kwargs.pop("method"),
+            },
+        )

sp_api/api/orders/orders.py

@@ -1,12 +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:
         """
@@ -53,6 +102,12 @@ class Orders(Client):
 
 
         """
+        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})
@@ -353,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/api/product_fees/product_fees.py

@@ -3,6 +3,7 @@ from urllib.parse import quote_plus
 
 from sp_api.base.helpers import sp_endpoint, fill_query_params
 from sp_api.base import Client, ApiResponse
+from sp_api.util.product_fees import create_fees_body
 
 
 class ProductFees(Client):
@@ -63,15 +64,15 @@ class ProductFees(Client):
             seller_sku = quote_plus(seller_sku)
 
         kwargs.update(
-            self._create_body(
-                price,
-                shipping_price,
-                currency,
-                is_fba,
-                seller_sku,
-                points,
-                marketplace_id,
-                optional_fulfillment_program,
+            create_fees_body(
+                price=price,
+                shipping_price=shipping_price,
+                currency=currency,
+                is_fba=is_fba,
+                identifier=seller_sku,
+                points=points,
+                marketplace_id=marketplace_id or self.marketplace_id,
+                optional_fulfillment_program=optional_fulfillment_program,
             )
         )
         return self._request(
@@ -124,15 +125,15 @@ class ProductFees(Client):
 
         """
         kwargs.update(
-            self._create_body(
-                price,
-                shipping_price,
-                currency,
-                is_fba,
-                asin,
-                points,
-                marketplace_id,
-                optional_fulfillment_program,
+            create_fees_body(
+                price=price,
+                shipping_price=shipping_price,
+                currency=currency,
+                is_fba=is_fba,
+                identifier=asin,
+                points=points,
+                marketplace_id=marketplace_id or self.marketplace_id,
+                optional_fulfillment_program=optional_fulfillment_program,
             )
         )
         return self._request(fill_query_params(kwargs.pop("path"), asin), data=kwargs)
@@ -166,7 +167,18 @@ class ProductFees(Client):
                 marketplace_id: str | Defaults to self.marketplace_id
                 optional_fulfillment_program:
         """
-        data = [dict(**self._create_body(**er)) for er in estimate_requests]
+        data = []
+        for estimate in estimate_requests:
+            estimate_payload = dict(estimate)
+            marketplace_id = estimate_payload.pop("marketplace_id", None)
+            data.append(
+                dict(
+                    **create_fees_body(
+                        marketplace_id=marketplace_id or self.marketplace_id,
+                        **estimate_payload,
+                    )
+                )
+            )
         return self._request(
             "/products/fees/v0/feesEstimate",
             data=data,
@@ -174,61 +186,6 @@ class ProductFees(Client):
             wrap_list=True,
         )
 
-    def _create_body(
-        self,
-        price,
-        shipping_price=None,
-        currency="USD",
-        is_fba=False,
-        identifier=None,
-        points: dict = None,
-        marketplace_id: str = None,
-        optional_fulfillment_program: str = None,
-        id_type=None,
-        id_value=None,
-    ):
-        """
-        Create request body
-
-        Args:
-            price:
-            shipping_price:
-            currency:
-            is_fba:
-            identifier:
-            points:
-
-        Returns:
-
-        """
-        body = {
-            "FeesEstimateRequest": {
-                "Identifier": identifier or str(price),
-                "PriceToEstimateFees": {
-                    "ListingPrice": {"Amount": price, "CurrencyCode": currency},
-                    "Shipping": (
-                        {"Amount": shipping_price, "CurrencyCode": currency}
-                        if shipping_price
-                        else None
-                    ),
-                    "Points": points or None,
-                },
-                "IsAmazonFulfilled": is_fba,
-                "OptionalFulfillmentProgram": (
-                    optional_fulfillment_program
-                    if is_fba is True and optional_fulfillment_program
-                    else None
-                ),
-                "MarketplaceId": marketplace_id or self.marketplace_id,
-            }
-        }
-
-        if id_type and id_value:
-            body["IdType"] = id_type
-            body["IdValue"] = id_value
-
-        return body
-
     def _add_marketplaces(self, data):
         # MarketplaceID is a property of the body's FeesEstimateRequest for this section, and does
         # not need to be added. Additionally, Client._add_marketplaces will fail as it assumes

sp_api/api/products/products.py

@@ -7,6 +7,7 @@ from sp_api.api.products.products_definitions import (
     GetItemOffersBatchRequest,
     GetListingOffersBatchRequest,
 )
+from sp_api.util import ensure_csv
 
 
 class Products(Client):
@@ -377,10 +378,11 @@ class Products(Client):
         )
 
     def _create_get_pricing_request(self, item_list, item_type, **kwargs):
+        items_csv = ensure_csv(item_list)
         return self._request(
             kwargs.pop("path"),
             params={
-                **{f"{item_type}s": ",".join(item_list)},
+                **{f"{item_type}s": items_csv},
                 "ItemType": item_type,
                 **(
                     {"ItemCondition": kwargs.pop("ItemCondition")}