Marketplaces / eBay / eBay Sell API Technical Scope / eBay Product Management / eBay Extended Producer Responsibility Done

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.

Is this article helpful?
0 0 0