eBay Extended Producer Responsibility Done
The purpose of this document is to give good understanding how we need to incorporate the new Extended Producer Responsibility.
eBay recently have introduced Extended Producer Responsibility(EPR) for eBay FR but other countries are likely to follow soon. All the changes need to be incorporated within our revise product cron for eBay - /var/www/ebay/bin/cron_ebay_001_revise_product.php
B2C sellers in certain categories selling “New” items will be required to provide information related to EPR (Extended Producer Responsibility): ⁃ Producer Product ID ⁃ Product Package ID ⁃ Shipping Package ID ⁃ Product Document ID ⁃ eco Participation Fee ⁃ Take Back Policy
- Compliance Policy
In order to push the new additional fields we will need to add them in Item Account eBay.
eBay Field | Hemi Field | Comment | ||
---|---|---|---|---|
Item | ||||
ExtendedProducerResponsibility |
||||
EcoParticipationFee |
Item Account eBay > eco Participation Fee | Amount Type double | ||
ProducerProductID |
Item Account eBay > Producer Product ID | string | ||
ProductPackageID |
Item Account eBay > Product Package ID | string | ||
ShipmentPackageID |
Item Account eBay > Shipping Package ID | string | ||
ProductDocumentationID |
Item Account eBay > Product Document ID | string | ||
CustomPolicies |
||||
ProductCompliancePolicyID |
Item Account eBay > Compliance Policy | ID obtained from eBay. | ||
Dropdown with multiple options for selection. | ||||
TakeBackPolicyID |
Item Account eBay >Take Back Policy | ID obtained from eBay. | ||
Dropdown |
If we have a variation group the EcoParticipationFee
should pushed as
eBay Field | Hemi Field | Comment | ||||
---|---|---|---|---|---|---|
Item | ||||||
Variations | ||||||
Variation | ||||||
VariationExtendedProducerResponsibility | ||||||
EcoParticipationFee | Item Account eBay > eco Participation Fee | Amount Type double |
“This is the fee paid for new items to the eco-organization (for example, "eco-organisme" in France) fee for each variation in a multiple-variation listing. It is a contribution to the financing of the elimination of the item responsibly. For multiple-variation listings, this EcoParticipationFee (in the VariationExtendedProducerResponsibility container) is used and not the EcoParticipationFee in the ExtendedProducerResponsibility container.”
ProductCompliancePolicyID
is a repeatable field which means we can add one or more compliance policy IDs.
“This field is used if the seller wants to apply one or more product compliance policies to the listing. A separate ProductCompliancePolicyID field is required for each policy to be applied, and the seller specifies the identifier of each policy in this field.”
We also should add ProductCompliancePolicyID
and TakeBackPolicyID
in Account eBay table where we can specify default options if nothing is selected on Item Account eBay > Compliance Policy and Item Account eBay >Take Back Policy.
- In order to get the
CustomPolicies
we will need to make additional call from the Account API.
API Call: GET https://api.ebay.com/sell/account/v1/custom_policy/?policy_types=string&
API Docs: https://developer.ebay.com/api-docs/sell/account/resources/custom_policy/methods/getCustomPolicies
Example Call:
We have no body for this request however in the headers we need to specify what type of policy we would like to get.
Two Custom Policy types are supported:
- Product Compliance (PRODUCT_COMPLIANCE)
- Takeback (TAKE_BACK)
*https://api.ebay.com/sell/account/v1/custom_policy/?policy_types=PRODUCT_COMPLIANCEhttps://api.ebay.com/sell/account/v1/custom_policy/?policy_types=TAKE_BACK*
Example Response:
{
"customPolicies": [
{
"customPolicyId": "string",
"label": "string",
"name": "string",
"policyType": "CustomPolicyTypeEnum : [PRODUCT_COMPLIANCE,TAKE_BACK]"
}
],
"href": "string",
"limit": "integer",
"next": "string",
"offset": "integer",
"prev": "string",
"total": "integer"
}
Response Mapping:
Integration Field | Integration Notes | Integration required | Hemi Mapping | Hemi Notes | |
---|---|---|---|---|---|
customPolicies | |||||
customPolicyId | The unique custom policy identifier for the policy being returned. | Yes | eBay Policies > Policy ID | New table and fields to be introduced | |
label | Customer-facing label shown on View Item pages for items to which the policy applies. This seller-defined string is displayed as a system-generated hyperlink pointing to detailed policy information. | No | N/A | N/A | |
name | The seller-defined name for the custom policy. Names must be unique for policies assigned to the same seller, policy type, and eBay marketplace. | Yes | eBay Policies > Policy Name | New table and fields to be introduced | |
policyType | Specifies the type of Custom Policy being returned. | No | eBay Policies > Policy Type | New table and fields to be introduced | |
href | N/A | N/A | N/A | This field is for future use. | |
limit | N/A | N/A | N/A | This field is for future use. | |
next | N/A | N/A | N/A | This field is for future use. | |
offset | N/A | N/A | N/A | This field is for future use. | |
prev | N/A | N/A | N/A | This field is for future use. | |
total | N/A | N/A | N/A | This field is for future use. |
Additional Information:
Please note the LMS and partial updates for eBay should be able to send this fields as well when we are updating or creating new products. The new Item Account eBay should be available for bulk update and import.