eBay Trading APIVersion 1371
 

RegulatoryType

Type defining the regulatory containers that are used at the listing level to provide Energy Efficiency Label information, hazardous material related information, product safety related information, manufacturer and responsible person information, and the repair score.

Type that uses RegulatoryType:

Calls that use RegulatoryType:

Fields



Documents ( DocumentsType ) [0..1]
This container provides a collection of regulatory documents associated with the listing.

For Revise and Relist calls: For information on removing one or more files using a Revise/Relist call, see Remove documents from listings.
Note: As a part of General Product Safety Regulation (GPSR) requirements effective on December 13th, 2024, sellers operating in, or shipping to, EU-based countries or Northern Ireland are conditionally required to provide regulatory document information in their eBay listings. For more information on GPSR, see General Product Safety Regulation (GPSR).
See the Field Index to learn which calls use Documents.

EconomicOperator ( EconomicOperatorType ) [0..1]
Note: Economic Operator is being decommissioned and being replaced by the Manufacturer and ResponsiblePersons containers. Economic Operator related fields should no longer be used for the Add/Revise/Relist and VerifyItem family of calls. As it is currently still supported, Economic Operator-related fields will be returned if applicable for the GetItem call. This container provides Economic Operator (EO) information about the manufacturer and/or supplier of the item. The EO is a corporate entity that is related to, has some responsibility for, the product being listed for sale. For additional information, see What is an economic operator?.
See the Field Index to learn which calls use EconomicOperator.

EnergyEfficiencyLabel ( EnergyEfficiencyType ) [0..1]
This container provides information about the energy efficiency for certain durable goods.
Note: As a part of Digital Services Act (DSA) requirements, all sellers who list products in Germany (DE) must provide Energy Efficiency Label information and Product Information Sheets for listings for certain durable goods. Note: Energy efficiency information is not required for all categories. Use the getRegulatoryPolicies method of the Metadata API to return metadata on the eBay categories that recommend or require energy efficiency-related fields.
See the Field Index to learn which calls use EnergyEfficiencyLabel.

Hazmat ( HazmatType ) [0..1]
This container is used by the seller to provide hazardous material information for the listing. Three elements are required to complete the Hazmat section of a listing: Pictograms, SignalWord, and Statements. The fourth element, Component, is optional. For more information, see Specifying hazardous material related information.
Note: Hazmat information is not required for all categories. Use the getRegulatoryPolicies method of the Metadata API to return metadata on the eBay categories that recommend or require Hazmat-related fields.
See the Field Index to learn which calls use Hazmat.

Manufacturer ( ManufacturerType ) [0..1]
This container provides information about the manufacturer of the item.

For Revise and Relist calls: To delete all manufacturer information when you revise or relist, specify Item.Regulatory.Manufacturer in DeletedField, and don't pass Manufacturer in the request.
Note: As a part of General Product Safety Regulation (GPSR) requirements effective on December 13th, 2024, sellers operating in, or shipping to, EU-based countries or Northern Ireland are conditionally required to provide product manufacturer information in their eBay listings. Manufacturer information is not required for all categories. Use the getRegulatoryPolicies method of the Metadata API to return metadata on the eBay categories that recommend or require manufacturer-related fields. For more information on GPSR, see General Product Safety Regulation (GPSR).
See the Field Index to learn which calls use Manufacturer.

ProductSafety ( ProductSafetyType ) [0..1]
This container is used to provide product safety information for the listing. Two elements are required to complete the product safety section for a listing: Pictograms and Statements. The Component element is optional.

For Revise and Relist calls: To delete all product safety information when you revise or relist, specify Item.Regulatory.ProductSafety in DeletedField, and don't pass ProductSafety in the request.
Note: As a part of General Product Safety Regulation (GPSR) requirements effective on December 13th, 2024, sellers operating in, or shipping to, EU-based countries or Northern Ireland are conditionally required to provide product manufacturer information in their eBay listings. Product safety information is not required for all categories. Use the getRegulatoryPolicies method of the Metadata API to return metadata on the eBay categories that recommend or require product safety-related fields. For more information on GPSR, see General Product Safety Regulation (GPSR).
See the Field Index to learn which calls use ProductSafety.

RepairScore ( double ) [0..1]
This field represents the repair index for the listing.

The repair index identifies the manufacturer's repair score for a product (how easy is it to repair the product). This field is a floating point value between 0 and 10 but may only have one digit beyond the decimal point, for example: 7.9
Note: 0 should not be used as a default value, as it implies that the product is not repairable.
See the Field Index to learn which calls use RepairScore.

ResponsiblePersons ( ResponsiblePersonsType ) [0..1]
This container provides information about the EU-based Responsible Persons or entities associated with the listing.

For Revise and Relist calls: To delete all Responsible Persons information when you revise or relist, specify Item.Regulatory.ResponsiblePersons in DeletedField, and don't pass ResponsiblePersons in the request.
Note: As a part of General Product Safety Regulation (GPSR) requirements effective on December 13th, 2024, sellers operating in, or shipping to, EU-based countries or Northern Ireland are conditionally required to provide Responsible Persons information in their eBay listings if the manufacture is not based in the EU. For more information on GPSR, see General Product Safety Regulation (GPSR).
See the Field Index to learn which calls use ResponsiblePersons.