diff --git a/CLAUDE.md b/CLAUDE.md
index 31f8649..fa9aeea0 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -108,7 +108,7 @@ All code lives under `etsy_python/v3/`:
**`_type` field mapping**: Python's `type` is a builtin, so model attributes that map to the API's `type` field are stored as `_type`. `todict()` in `Utils.py` maps `_type` → `"type"` during serialization. The mandatory list in Request models must use `"_type"` (the attribute name), not `"type"`.
-**Boolean False vs nullable**: `get_nulled()` in `Request.py` treats empty strings, empty lists, and zero as null for nullable fields — but explicitly excludes `bool` values. `False` is a valid distinct value from null and serializes as `False`, not `None`. The `todict()` function in `Utils.py` has the same guard: `(value != 0 or isinstance(value, bool))`.
+**Boolean False vs nullable**: `get_nulled()` in `Request.py` treats empty strings, empty lists, and zero as null for nullable fields — but explicitly excludes `bool` values. `False` is a valid distinct value from null and serializes as `False`, not `None`. Both share one rule, `is_null_value()` in `Utils.py`. The `CLEAR` sentinel (`from etsy_python.v3.common.Utils import CLEAR`) is the explicit way to send `null` for a nullable field; `Request` raises `ValueError` when `CLEAR` is set on a non-nullable field. That check lives in `Request._validate()`, which runs on construction and again in `get_dict()`; models extend it (calling `super()`) for checks such as blank strings or GPSR type/id pairs.
### Request Flow
diff --git a/README.md b/README.md
index 05f7ffc..c992fb7 100644
--- a/README.md
+++ b/README.md
@@ -322,7 +322,7 @@ The SDK provides comprehensive coverage of Etsy API v3 resources:
### Commerce Resources
- **ListingInventory** - Stock and SKU management
-- **ListingOffering** - Product offering details
+- **ListingOffering** - Product offering details (deprecated: Etsy removed the endpoint)
- **ListingProduct** - Product variant management
- **Payment** - Payment processing
- **PaymentLedgerEntry** - Payment ledger entries
@@ -332,6 +332,7 @@ The SDK provides comprehensive coverage of Etsy API v3 resources:
- **ShopSection** - Organize listings into sections
- **ShopReturnPolicy** - Define return policies
+- **ShopEconomicOperator** - Manage GPSR manufacturer and EU responsible person records
- **ShopProductionPartner** - Manage production partners
- **HolidayPreferences** - Shop holiday schedule
- **ProcessingProfile** - Processing time profiles
diff --git a/etsy_python/v3/common/Utils.py b/etsy_python/v3/common/Utils.py
index 6bd71e0..c9368c1 100644
--- a/etsy_python/v3/common/Utils.py
+++ b/etsy_python/v3/common/Utils.py
@@ -3,6 +3,41 @@
from typing import Any, Dict, Iterable, List, Optional
+class Clear:
+ """Type of ``CLEAR``. Use the ``CLEAR`` instance, not this class."""
+
+ def __repr__(self) -> str:
+ return "CLEAR"
+
+ # Copies and pickle round trips (task queues, multiprocessing) must stay
+ # the module singleton; an identity check would miss a fresh instance.
+ def __copy__(self) -> "Clear":
+ return self
+
+ def __deepcopy__(self, memo: Dict[int, Any]) -> "Clear":
+ return self
+
+ def __reduce__(self) -> str:
+ return "CLEAR"
+
+
+#: Pass as the value of a nullable request field to send ``null`` and clear the
+#: stored value. On most older models ``""``, ``[]`` and ``0`` (but not
+#: ``False``) do the same for backward compatibility, and their type hints do
+#: not list ``Clear`` yet. Fields added since ``CLEAR`` accept it in their hints.
+CLEAR = Clear()
+
+
+def is_null_value(value: Any) -> bool:
+ """True for the values a nullable request field sends as JSON ``null``."""
+ return (
+ isinstance(value, Clear)
+ or value == []
+ or value == ""
+ or (value == 0 and not isinstance(value, bool))
+ )
+
+
def warn_removed_legacy_param(operation_id: str) -> None:
"""Warn that `legacy` was removed from an operation and is no longer sent.
@@ -54,6 +89,12 @@ def generate_get_uri(uri: str, params: Optional[Dict[str, Any]] = None) -> str:
def todict(
obj: Any, classkey: Optional[str] = None, nullable: Optional[List[str]] = None
) -> Any:
+ """Serialize ``obj`` for the API.
+
+ A key in ``nullable`` is sent as ``null`` only when its value is a null
+ value (``is_null_value``); a real value is kept. External callers may pass a
+ model's full nullable list, so this check must stay value-safe.
+ """
if nullable is None:
nullable = []
if isinstance(obj, dict):
@@ -63,6 +104,8 @@ def todict(
return data
elif Enum in obj.__class__.__mro__:
return todict(obj.value)
+ elif isinstance(obj, Clear):
+ return None
elif hasattr(obj, "_ast"):
return todict(obj._ast())
elif hasattr(obj, "__iter__") and not isinstance(obj, str):
@@ -71,10 +114,12 @@ def todict(
data = dict(
[
# _type -> "type": avoids shadowing Python's builtin in model attrs
- ("type" if key == "_type" else key, todict(value, classkey))
- if key not in nullable
- or (value != [] and value != "" and (value != 0 or isinstance(value, bool)))
- else (key, None)
+ (
+ "type" if key == "_type" else key,
+ None
+ if key in nullable and is_null_value(value)
+ else todict(value, classkey),
+ )
for key, value in obj.__dict__.items()
if not callable(value)
and (not key.startswith("_") or key == "_type")
diff --git a/etsy_python/v3/enums/Listing.py b/etsy_python/v3/enums/Listing.py
index d8e0d57..b5d2c22 100644
--- a/etsy_python/v3/enums/Listing.py
+++ b/etsy_python/v3/enums/Listing.py
@@ -46,6 +46,11 @@ class ItemDimensionsUnit(Enum):
INCHES = "inches"
+class GPSROperatorType(Enum):
+ SELLER = "seller"
+ ECONOMIC_OPERATOR = "economic_operator"
+
+
class Type(Enum):
PHYSICAL = "physical"
DOWNLOAD = "download"
diff --git a/etsy_python/v3/models/Listing.py b/etsy_python/v3/models/Listing.py
index 2951520..9bd9c4b 100644
--- a/etsy_python/v3/models/Listing.py
+++ b/etsy_python/v3/models/Listing.py
@@ -1,7 +1,9 @@
import warnings
-from typing import List, Optional, Dict, Any
+from typing import List, Optional, Dict, Any, Union
+from etsy_python.v3.common.Utils import Clear, is_null_value
from etsy_python.v3.enums.Listing import (
+ GPSROperatorType,
WhoMade,
WhenMade,
ItemWeightUnit,
@@ -195,7 +197,70 @@ def _store_ecgt(
self.ecgt_software_update_details = ecgt_software_update_details
-class CreateDraftListingRequest(_PersonalizationFieldsMixin, _ECGTFieldsMixin, Request):
+#: GPSR economic operator fields, shared by createDraftListing and updateListing.
+#: All are optional and nullable: pass ``CLEAR`` to send ``null`` and clear the
+#: stored value. Each ``*_id`` is an ``economic_operator_id`` from
+#: ``ShopEconomicOperatorResource``; Etsy requires it when the matching
+#: ``*_type`` is ``GPSROperatorType.ECONOMIC_OPERATOR`` and rejects it otherwise.
+GPSR_FIELDS = (
+ "gpsr_manufacturer_type",
+ "gpsr_manufacturer_id",
+ "gpsr_responsible_person_type",
+ "gpsr_responsible_person_id",
+ "gpsr_serial_number",
+ "gpsr_safety_warnings",
+)
+
+
+def _check_gpsr_operator_ids(values: Dict[str, Any], creating: bool) -> None:
+ """Raise ValueError for a GPSR type/id pair that Etsy would reject.
+
+ An id is valid only with type ``economic_operator``, which needs an id on
+ create and can never be sent with a cleared id. On update the listing may
+ already store the other half of the pair, so a type without an id, or an id
+ without a type, is left to Etsy.
+ """
+ for role in ("gpsr_manufacturer", "gpsr_responsible_person"):
+ kind = values[f"{role}_type"]
+ operator_id = values[f"{role}_id"]
+ if kind is None and not creating:
+ continue
+ has_id = operator_id is not None and not is_null_value(operator_id)
+ is_operator = (
+ getattr(kind, "value", kind) == GPSROperatorType.ECONOMIC_OPERATOR.value
+ )
+ clears_id = operator_id is not None and not has_id
+ if is_operator and (clears_id or (creating and not has_id)):
+ raise ValueError(
+ f"{role}_id is required when {role}_type is economic_operator"
+ )
+ if has_id and not is_operator:
+ raise ValueError(
+ f"{role}_id is only valid when {role}_type is economic_operator"
+ )
+
+
+class _GPSRFieldsMixin:
+ """Storage and type/id validation for the GPSR listing fields.
+
+ Each model sets ``_gpsr_creating``. See ``GPSR_FIELDS``.
+ """
+
+ _gpsr_creating: bool
+
+ def _store_gpsr(self, **values: Any) -> None:
+ self._assign_fields(GPSR_FIELDS, values)
+
+ def _validate(self) -> None:
+ super()._validate()
+ _check_gpsr_operator_ids(vars(self), creating=self._gpsr_creating)
+
+
+class CreateDraftListingRequest(
+ _PersonalizationFieldsMixin, _ECGTFieldsMixin, _GPSRFieldsMixin, Request
+):
+ _gpsr_creating = True
+
nullable = [
"shipping_profile_id",
"return_policy_id",
@@ -215,6 +280,7 @@ class CreateDraftListingRequest(_PersonalizationFieldsMixin, _ECGTFieldsMixin, R
"image_ids",
"readiness_state_id",
*ECGT_FIELDS,
+ *GPSR_FIELDS,
]
mandatory = [
"quantity",
@@ -268,6 +334,12 @@ def __init__(
ecgt_other_commercial_guarantee_details: Optional[str] = None,
ecgt_after_sales_service_info: Optional[str] = None,
ecgt_software_update_details: Optional[str] = None,
+ gpsr_manufacturer_type: Union[GPSROperatorType, Clear, None] = None,
+ gpsr_manufacturer_id: Union[int, Clear, None] = None,
+ gpsr_responsible_person_type: Union[GPSROperatorType, Clear, None] = None,
+ gpsr_responsible_person_id: Union[int, Clear, None] = None,
+ gpsr_serial_number: Union[str, Clear, None] = None,
+ gpsr_safety_warnings: Union[str, Clear, None] = None,
):
self.quantity = quantity
self.title = title
@@ -313,13 +385,25 @@ def __init__(
ecgt_after_sales_service_info,
ecgt_software_update_details,
)
+ self._store_gpsr(
+ gpsr_manufacturer_type=gpsr_manufacturer_type,
+ gpsr_manufacturer_id=gpsr_manufacturer_id,
+ gpsr_responsible_person_type=gpsr_responsible_person_type,
+ gpsr_responsible_person_id=gpsr_responsible_person_id,
+ gpsr_serial_number=gpsr_serial_number,
+ gpsr_safety_warnings=gpsr_safety_warnings,
+ )
super().__init__(
nullable=CreateDraftListingRequest.nullable,
mandatory=CreateDraftListingRequest.mandatory,
)
-class UpdateListingRequest(_PersonalizationFieldsMixin, _ECGTFieldsMixin, Request):
+class UpdateListingRequest(
+ _PersonalizationFieldsMixin, _ECGTFieldsMixin, _GPSRFieldsMixin, Request
+):
+ _gpsr_creating = False
+
nullable: List[str] = [
"materials",
"shipping_profile_id",
@@ -335,6 +419,7 @@ class UpdateListingRequest(_PersonalizationFieldsMixin, _ECGTFieldsMixin, Reques
"production_partner_ids",
"_type",
*ECGT_FIELDS,
+ *GPSR_FIELDS,
]
mandatory: List[str] = []
@@ -376,6 +461,12 @@ def __init__(
ecgt_other_commercial_guarantee_details: Optional[str] = None,
ecgt_after_sales_service_info: Optional[str] = None,
ecgt_software_update_details: Optional[str] = None,
+ gpsr_manufacturer_type: Union[GPSROperatorType, Clear, None] = None,
+ gpsr_manufacturer_id: Union[int, Clear, None] = None,
+ gpsr_responsible_person_type: Union[GPSROperatorType, Clear, None] = None,
+ gpsr_responsible_person_id: Union[int, Clear, None] = None,
+ gpsr_serial_number: Union[str, Clear, None] = None,
+ gpsr_safety_warnings: Union[str, Clear, None] = None,
):
self.image_ids = image_ids
self.title = title
@@ -419,6 +510,14 @@ def __init__(
ecgt_after_sales_service_info,
ecgt_software_update_details,
)
+ self._store_gpsr(
+ gpsr_manufacturer_type=gpsr_manufacturer_type,
+ gpsr_manufacturer_id=gpsr_manufacturer_id,
+ gpsr_responsible_person_type=gpsr_responsible_person_type,
+ gpsr_responsible_person_id=gpsr_responsible_person_id,
+ gpsr_serial_number=gpsr_serial_number,
+ gpsr_safety_warnings=gpsr_safety_warnings,
+ )
super().__init__(
nullable=UpdateListingRequest.nullable,
mandatory=UpdateListingRequest.mandatory,
diff --git a/etsy_python/v3/models/Request.py b/etsy_python/v3/models/Request.py
index 910d56d..2e8f597 100644
--- a/etsy_python/v3/models/Request.py
+++ b/etsy_python/v3/models/Request.py
@@ -1,6 +1,6 @@
-from typing import Optional, List, Any
+from typing import Any, Dict, List, Optional, Sequence
-from etsy_python.v3.common.Utils import todict
+from etsy_python.v3.common.Utils import Clear, is_null_value, todict
class Request:
@@ -13,6 +13,7 @@ def __init__(
self._mandatory = mandatory if mandatory is not None else []
if not self.check_mandatory():
raise ValueError
+ self._validate()
def check_mandatory(self) -> bool:
# Keys must match the attribute name (e.g. "_type", not "type").
@@ -25,13 +26,42 @@ def check_mandatory(self) -> bool:
return False
return True
+ def _validate(self) -> None:
+ """Raise ValueError for field values Etsy would reject.
+
+ Runs on construction and again in ``get_dict``, because fields can be
+ reassigned in between. Subclasses extend it and call ``super()``.
+ """
+ self._reject_clear_on_non_nullable()
+
+ def _reject_clear_on_non_nullable(self) -> None:
+ misplaced = [
+ key.lstrip("_")
+ for key, value in self.__dict__.items()
+ if isinstance(value, Clear) and key not in self._nullable
+ ]
+ if misplaced:
+ raise ValueError(
+ "CLEAR is only valid for nullable fields: " + ", ".join(misplaced)
+ )
+
+ def _assign_fields(self, names: Sequence[str], values: Dict[str, Any]) -> None:
+ """Set each named field from ``values``, which must hold exactly ``names``."""
+ if set(values) != set(names):
+ raise TypeError(
+ f"expected fields {sorted(names)}, got {sorted(values)}"
+ )
+ for name in names:
+ setattr(self, name, values[name])
+
def get_nulled(self) -> List[str]:
return [
key
for key, value in self.__dict__.items()
- if key in self._nullable and (value == [] or value == "" or (value == 0 and not isinstance(value, bool)))
+ if key in self._nullable and is_null_value(value)
]
def get_dict(self) -> Any:
+ self._validate()
nulled = self.get_nulled()
return todict(self, nullable=nulled)
diff --git a/etsy_python/v3/models/ShopEconomicOperator.py b/etsy_python/v3/models/ShopEconomicOperator.py
new file mode 100644
index 0000000..0df9f34
--- /dev/null
+++ b/etsy_python/v3/models/ShopEconomicOperator.py
@@ -0,0 +1,145 @@
+from typing import Any, List, Optional, Union
+
+from etsy_python.v3.common.Utils import Clear
+from etsy_python.v3.models.Request import Request
+
+#: Every body field of createShopEconomicOperator and updateShopEconomicOperator.
+OPERATOR_FIELDS = (
+ "operator_name",
+ "email",
+ "first_line",
+ "second_line",
+ "city",
+ "state",
+ "zip",
+ "country_iso",
+ "phone",
+ "phone_country_iso",
+ "trademark_name",
+)
+
+#: Required on create.
+REQUIRED_FIELDS = (
+ "operator_name",
+ "email",
+ "first_line",
+ "city",
+ "zip",
+ "country_iso",
+ "phone",
+)
+
+
+class _ShopEconomicOperatorRequest(Request):
+ """Shared storage and validation. Clear a field with CLEAR, never ``""``."""
+
+ def _store_operator_fields(self, **values: Any) -> None:
+ self._assign_fields(OPERATOR_FIELDS, values)
+
+ def _validate(self) -> None:
+ super()._validate()
+ blank = [
+ name
+ for name in OPERATOR_FIELDS
+ if isinstance(getattr(self, name), str) and not getattr(self, name).strip()
+ ]
+ if blank:
+ raise ValueError("cannot be blank: " + ", ".join(blank))
+
+
+class CreateShopEconomicOperatorRequest(_ShopEconomicOperatorRequest):
+ # A new record has nothing to clear.
+ nullable: List[str] = []
+ # A literal list, not list(REQUIRED_FIELDS): scripts/audit_sdk.py reads it
+ # from the source.
+ mandatory: List[str] = [
+ "operator_name",
+ "email",
+ "first_line",
+ "city",
+ "zip",
+ "country_iso",
+ "phone",
+ ]
+
+ def __init__(
+ self,
+ operator_name: str,
+ email: str,
+ first_line: str,
+ city: str,
+ zip: str,
+ country_iso: str,
+ phone: str,
+ second_line: Optional[str] = None,
+ state: Optional[str] = None,
+ phone_country_iso: Optional[str] = None,
+ trademark_name: Optional[str] = None,
+ ) -> None:
+ # Etsy requires state for some countries (e.g. US, CA, AU) and rejects
+ # the request server-side when it is missing.
+ self._store_operator_fields(
+ operator_name=operator_name,
+ email=email,
+ first_line=first_line,
+ second_line=second_line,
+ city=city,
+ state=state,
+ zip=zip,
+ country_iso=country_iso,
+ phone=phone,
+ phone_country_iso=phone_country_iso,
+ trademark_name=trademark_name,
+ )
+ super().__init__(
+ nullable=CreateShopEconomicOperatorRequest.nullable,
+ mandatory=CreateShopEconomicOperatorRequest.mandatory,
+ )
+
+
+class UpdateShopEconomicOperatorRequest(_ShopEconomicOperatorRequest):
+ # Pass CLEAR for one of these to send null and clear the stored value.
+ nullable: List[str] = [
+ "second_line",
+ "state",
+ "phone_country_iso",
+ "trademark_name",
+ ]
+ mandatory: List[str] = []
+
+ def _validate(self) -> None:
+ super()._validate()
+ if all(getattr(self, name) is None for name in OPERATOR_FIELDS):
+ raise ValueError("set at least one field to update")
+
+ def __init__(
+ self,
+ operator_name: Optional[str] = None,
+ email: Optional[str] = None,
+ first_line: Optional[str] = None,
+ second_line: Union[str, Clear, None] = None,
+ city: Optional[str] = None,
+ state: Union[str, Clear, None] = None,
+ zip: Optional[str] = None,
+ country_iso: Optional[str] = None,
+ phone: Optional[str] = None,
+ phone_country_iso: Union[str, Clear, None] = None,
+ trademark_name: Union[str, Clear, None] = None,
+ ) -> None:
+ self._store_operator_fields(
+ operator_name=operator_name,
+ email=email,
+ first_line=first_line,
+ second_line=second_line,
+ city=city,
+ state=state,
+ zip=zip,
+ country_iso=country_iso,
+ phone=phone,
+ phone_country_iso=phone_country_iso,
+ trademark_name=trademark_name,
+ )
+ super().__init__(
+ nullable=UpdateShopEconomicOperatorRequest.nullable,
+ mandatory=UpdateShopEconomicOperatorRequest.mandatory,
+ )
diff --git a/etsy_python/v3/models/__init__.py b/etsy_python/v3/models/__init__.py
index 62189bd..ec2bdfa 100644
--- a/etsy_python/v3/models/__init__.py
+++ b/etsy_python/v3/models/__init__.py
@@ -1,3 +1,4 @@
+from etsy_python.v3.common.Utils import CLEAR, Clear
from .FileRequest import FileRequest
from .Listing import (
CreateDraftListingRequest,
@@ -24,6 +25,10 @@
UpdateShopShippingProfileUpgradeRequest,
)
from .Shop import CreateShopSectionRequest, UpdateShopSectionRequest, UpdateShopRequest
+from .ShopEconomicOperator import (
+ CreateShopEconomicOperatorRequest,
+ UpdateShopEconomicOperatorRequest,
+)
from .ShopReturnPolicy import (
ConsolidateShopReturnPoliciesRequest,
CreateShopReturnPolicyRequest,
diff --git a/etsy_python/v3/resources/ListingOffering.py b/etsy_python/v3/resources/ListingOffering.py
index b18b2fd..2094091 100644
--- a/etsy_python/v3/resources/ListingOffering.py
+++ b/etsy_python/v3/resources/ListingOffering.py
@@ -1,3 +1,4 @@
+import warnings
from dataclasses import dataclass
from typing import Optional, Dict, Any, Union
@@ -10,10 +11,27 @@
class ListingOfferingResource:
session: EtsyClient
+ def __post_init__(self) -> None:
+ warnings.warn(
+ "ListingOfferingResource is deprecated: Etsy removed its only "
+ "endpoint, getListingOffering, from the Open API v3 spec. It will "
+ "be removed in a future major version.",
+ DeprecationWarning,
+ stacklevel=3,
+ )
+
def get_listing_offering(
self, listing_id: int, product_id: int, product_offering_id: int,
legacy: Optional[bool] = None,
) -> Union[Response, RequestException]:
+ """Deprecated: Etsy removed getListingOffering from the Open API v3 spec."""
+ warnings.warn(
+ "get_listing_offering is deprecated: Etsy removed getListingOffering "
+ "from the Open API v3 spec, so the request may fail. It will be "
+ "removed in a future major version.",
+ DeprecationWarning,
+ stacklevel=2,
+ )
endpoint = f"/listings/{listing_id}/products/{product_id}/offerings/{product_offering_id}"
query_params: Dict[str, Any] = {"legacy": legacy}
return self.session.make_request(endpoint, query_params=query_params)
diff --git a/etsy_python/v3/resources/ShopEconomicOperator.py b/etsy_python/v3/resources/ShopEconomicOperator.py
new file mode 100644
index 0000000..68adaf4
--- /dev/null
+++ b/etsy_python/v3/resources/ShopEconomicOperator.py
@@ -0,0 +1,55 @@
+from dataclasses import dataclass
+from typing import Union
+
+from etsy_python.v3.exceptions.RequestException import RequestException
+from etsy_python.v3.models.ShopEconomicOperator import (
+ CreateShopEconomicOperatorRequest,
+ UpdateShopEconomicOperatorRequest,
+)
+from etsy_python.v3.resources.Response import Response
+from etsy_python.v3.resources.Session import EtsyClient
+from etsy_python.v3.resources.enums.Request import Method
+
+
+@dataclass
+class ShopEconomicOperatorResource:
+ """GPSR manufacturer and EU responsible person records of a shop.
+
+ Etsy has no delete endpoint for economic operators; correct a record with
+ ``update_shop_economic_operator`` instead.
+ """
+
+ session: EtsyClient
+
+ def create_shop_economic_operator(
+ self,
+ shop_id: int,
+ economic_operator_request: CreateShopEconomicOperatorRequest,
+ ) -> Union[Response, RequestException]:
+ endpoint = f"/shops/{shop_id}/economic-operators"
+ return self.session.make_request(
+ endpoint, method=Method.POST, payload=economic_operator_request
+ )
+
+ def get_shop_economic_operators(
+ self, shop_id: int
+ ) -> Union[Response, RequestException]:
+ endpoint = f"/shops/{shop_id}/economic-operators"
+ return self.session.make_request(endpoint)
+
+ def get_shop_economic_operator(
+ self, shop_id: int, economic_operator_id: int
+ ) -> Union[Response, RequestException]:
+ endpoint = f"/shops/{shop_id}/economic-operators/{economic_operator_id}"
+ return self.session.make_request(endpoint)
+
+ def update_shop_economic_operator(
+ self,
+ shop_id: int,
+ economic_operator_id: int,
+ economic_operator_request: UpdateShopEconomicOperatorRequest,
+ ) -> Union[Response, RequestException]:
+ endpoint = f"/shops/{shop_id}/economic-operators/{economic_operator_id}"
+ return self.session.make_request(
+ endpoint, method=Method.PATCH, payload=economic_operator_request
+ )
diff --git a/etsy_python/v3/resources/__init__.py b/etsy_python/v3/resources/__init__.py
index 2c21c11..39768a4 100644
--- a/etsy_python/v3/resources/__init__.py
+++ b/etsy_python/v3/resources/__init__.py
@@ -21,6 +21,7 @@
from .Session import EtsyClient
from .ShippingProfile import ShippingProfileResource
from .Shop import ShopResource
+from .ShopEconomicOperator import ShopEconomicOperatorResource
from .ShopProductionPartner import ShopProductionPartnerResource
from .ShopReturnPolicy import ShopReturnPolicyResource
from .ShopSection import ShopSectionResource
diff --git a/specs/audit-ignore.json b/specs/audit-ignore.json
index 9f5600c..341f67c 100644
--- a/specs/audit-ignore.json
+++ b/specs/audit-ignore.json
@@ -185,6 +185,12 @@
],
"reason": "Etsy removed is_personalizable, personalization_is_required, personalization_char_count_max and personalization_instructions from the createDraftListing and updateListing request bodies (2026-09 spec); personalization now lives on the dedicated personalization endpoints (update_listing_personalization). The constructor kwargs are retained so existing callers don't break, but the values are stored under underscore-prefixed names that todict excludes, so they are never sent on the wire, and setting one emits a DeprecationWarning. Remove the kwargs (and this entry) in the next major version. featured_rank was also removed from the updateListing body (2026-10 spec) and is handled the same way: stored as _featured_rank, never sent, and setting it emits a DeprecationWarning.",
"added": "2026-09-06"
+ },
+ {
+ "type": "extra_method",
+ "key": "ListingOfferingResource.get_listing_offering",
+ "reason": "Etsy removed getListingOffering from the spec (2026-11). The method is kept so existing callers don't break, but it emits a DeprecationWarning because the request may fail. Remove the method, ListingOfferingResource, and this entry in the next major version.",
+ "added": "2026-11-10"
}
]
}
diff --git a/specs/baseline.json b/specs/baseline.json
index 1527829..2e3cbcb 100644
--- a/specs/baseline.json
+++ b/specs/baseline.json
@@ -57,6 +57,10 @@
{
"name": "Shop HolidayPreferences"
},
+ {
+ "name": "Shop Economic Operators",
+ "description": "Economic operators are used to identify the manufacturer and EU responsible person records that the EU General Product Safety Regulation (GPSR) asks sellers to attach to the products they sell to EU buyers. Create them with these endpoints, then reference them from [listings](/documentation/reference#tag/ShopListing) through the `gpsr_*` fields on [createDraftListing](/documentation/reference#operation/createDraftListing) and [updateListing](/documentation/reference#operation/updateListing). See the [GPSR Economic Operators Tutorial](/documentation/tutorials/gpsr-economic-operators) for eligibility, the enforcement timeline, validation rules, and examples."
+ },
{
"name": "SellerTaxonomy"
},
@@ -87,9 +91,6 @@
{
"name": "ShopListing Inventory"
},
- {
- "name": "ShopListing Offering"
- },
{
"name": "ShopListing Product"
},
@@ -113,7 +114,6 @@
"ShopListing File",
"ShopListing Image",
"ShopListing Inventory",
- "ShopListing Offering",
"ShopListing Personalization",
"ShopListing Product",
"ShopListing Translation",
@@ -159,6 +159,7 @@
"name": "Shop Management",
"tags": [
"Shop",
+ "Shop Economic Operators",
"Shop ProductionPartner",
"Shop Section"
]
@@ -546,6 +547,46 @@
"description": "Details of software update availability and the duration of such updates, as required under EU ECGT regulations for digital content. Maximum 255 characters. Silently ignored for physical listings and for sellers who are not eligible EU traders.",
"nullable": true
},
+ "gpsr_manufacturer_type": {
+ "type": "string",
+ "description": "Who the manufacturer of this product is, for GPSR (EU General Product Safety Regulation) purposes. Either `seller` (your shop is the manufacturer) or `economic_operator` (a manufacturer record from the [Shop Economic Operators](/documentation/reference#tag/Shop-Economic-Operators) endpoints, identified by `gpsr_manufacturer_id`). `seller` is rejected when `who_made` is `someone_else`; use `economic_operator` for items made by a third party. Send `null` to clear. Optional for now; it becomes required for listings from eligible traders that sell into the EU 60 days after these fields were announced. See the [GPSR Economic Operators Tutorial](/documentation/tutorials/gpsr-economic-operators) for eligibility and the full flow.",
+ "nullable": true,
+ "enum": [
+ "seller",
+ "economic_operator"
+ ]
+ },
+ "gpsr_manufacturer_id": {
+ "type": "integer",
+ "description": "The `economic_operator_id` of the manufacturer, from the [Shop Economic Operators](/documentation/reference#tag/Shop-Economic-Operators) endpoints. Required when `gpsr_manufacturer_type` is `economic_operator`, and rejected when the type is anything else. The operator must belong to this shop and not be deleted. The manufacturer may be located anywhere in the world. If you change `gpsr_manufacturer_type` to `seller` without sending this field, the stored id is cleared for you.",
+ "format": "int64",
+ "nullable": true
+ },
+ "gpsr_responsible_person_type": {
+ "type": "string",
+ "description": "Who the EU responsible person for this product is, for GPSR purposes. Either `seller` (your shop; only valid when the shop's legal address, or the address on file, is in the European Union) or `economic_operator` (a record from the [Shop Economic Operators](/documentation/reference#tag/Shop-Economic-Operators) endpoints, identified by `gpsr_responsible_person_id`, which must have an address in the European Union). Send `null` to clear. Optional for now; it becomes required for listings from eligible traders that sell into the EU 60 days after these fields were announced. See the [GPSR Economic Operators Tutorial](/documentation/tutorials/gpsr-economic-operators) for eligibility and the full flow.",
+ "nullable": true,
+ "enum": [
+ "seller",
+ "economic_operator"
+ ]
+ },
+ "gpsr_responsible_person_id": {
+ "type": "integer",
+ "description": "The `economic_operator_id` of the EU responsible person, from the [Shop Economic Operators](/documentation/reference#tag/Shop-Economic-Operators) endpoints. Required when `gpsr_responsible_person_type` is `economic_operator`, and rejected when the type is anything else. The operator must belong to this shop and not be deleted, and its address must be in the European Union. If you change `gpsr_responsible_person_type` to `seller` without sending this field, the stored id is cleared for you.",
+ "format": "int64",
+ "nullable": true
+ },
+ "gpsr_serial_number": {
+ "type": "string",
+ "description": "An optional serial number, batch number, or lot identifier that lets the product be traced for GPSR purposes. Maximum 255 characters. Send `null` to clear.",
+ "nullable": true
+ },
+ "gpsr_safety_warnings": {
+ "type": "string",
+ "description": "Optional free-text safety warnings and safety information for the product regarding GPSR purposes, shown to buyers as product safety information on the listing page (for example age restrictions, choking hazards, or care and handling instructions). Maximum 102,400 characters. Send `null` to clear.",
+ "nullable": true
+ },
"is_supply": {
"type": "boolean",
"description": "When true, tags the listing as a supply product, else indicates that it's a finished product. Helps buyers locate the listing under the Supplies heading. Requires 'who_made' and 'when_made'."
@@ -933,7 +974,7 @@
},
"get": {
"operationId": "getListing",
- "description": "This endpoint is ready for production use.
This endpoint is ready for production use.
This endpoint is ready for production use.
This endpoint is ready for production use.
This endpoint is ready for production use.
This endpoint is ready for production use.
This endpoint is ready for production use.
This endpoint is ready for production use.
This endpoint is ready for production use.
This endpoint is ready for production use.
This endpoint is ready for production use.