Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Structured product returns #2288

Closed
danbri opened this issue Jun 19, 2019 · 7 comments
Closed

Structured product returns #2288

danbri opened this issue Jun 19, 2019 · 7 comments
Assignees

Comments

@danbri
Copy link
Contributor

danbri commented Jun 19, 2019

(proposal from Google)

It would be useful for Schema.org to have expressivity that allowed various merchants to describe their return policies. As always there are various levels of detail that might be made explicit. Our suggestion is to start with something like the following:

Main concepts:

  • Return Policy URL
  • Return Window Type [Finite, Infinite, Final Sale (no returns accepted)]
  • Refund Type [Store Credit, Full Refund, Exchange]
  • Return Fees [Original shipping, return shipping, restocking fees]

Plus these as "useful to have":

  • Are in-store returns offered? [Yes, No]
  • Exceptions [Category, Return Information including window, type, fees]

Exceptions would be things like "this policy applies to everything except fish and electronics..." and are consequently difficult here because of the lack of a common taxonomy to point into. The usual Schema.org workaround in such a case would be to at least document text or URL values.

@danbri danbri self-assigned this Jun 19, 2019
danbri added a commit that referenced this issue Jun 19, 2019
Needs definition texts adding. Examples too.
@danbri
Copy link
Contributor Author

danbri commented Jun 19, 2019

First cut at an implemented proposal:

Example usage (I've not added this to repo):

{
"@context": "http://schema.org/",
"@type": "Organization",
"name": "Macys",
"url": "https://www.macys.com/",
"hasProductReturnPolicy": 
  {
    "@type": "http://schema.org/ProductReturnPolicy",
     "productReturnLink": "https://www.customerservice-macys.com/app/answers/detail/a_id/140/~/what-is-macys-return-policy%3F",
    "productReturnCategory": "Finite",
    "productReturnDays": "180",
    "refundType": "FullRefund",
    "inStoreReturnsOffered": "True",
    "productReturnExceptions": "Apple Products, area rugs, backstage, beauty box, bluemercury, bonus gifts, bridal salon, cosmetics & fragrances, designer brands, dresses, final sale/as is furniture and mattresses, finish line, fur vault, furniture, gourmet food & wine, home accessories, jewelry, last act, lighting, locker room by lids, maternity, mattresses, optical, personal care, small electrics, style your ring, sunglass hut"
  }
}

danbri added a commit that referenced this issue Jul 2, 2019
Also added a disclaimer that the enumeration doesn't capture all
aspects of the policies.
/cc #2288
@ronnieroyston
Copy link

hasProductReturnPolicy does not pass Google's structured data testing tool. You can paste the snippet in there.

@RichardWallis
Copy link
Contributor

@rhroyston That's probably because there is some inevitable delay between new terms entering the vocabulary specification and they being supported in various testing tools and environments.

The assumption is they will be soon. It might be worth providing feedback in the SDTT to encourage it's support.

@danbri
Copy link
Contributor Author

danbri commented Mar 3, 2020

(See #2381 for the renaming)

@RichardWallis
Copy link
Contributor

Implemented

@otto-poulpe
Copy link

otto-poulpe commented Nov 30, 2023

I've got issues with https://schema.org/ReturnFeesEnumeration, only https://schema.org/FreeReturn can be validate on https://search.google.com/test/rich-results, but it does not fit my need... I would rather use https://schema.org/ReturnShippingFees.. Here is my Json mark up :
"offers": {
"@type": "Offer",
"url": "https://www.vapoter.fr/t17553-frm-alfaliquid-10ml",
"priceCurrency": "EUR",
"price": "5.9",
"priceValidUntil": "2025-03-25",
"availability": "https://schema.org/InStock",
"itemCondition": "https://schema.org/NewCondition",
"hasMerchantReturnPolicy": {
"@type": "MerchantReturnPolicy",
"applicableCountry": "FR",
"returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow",
"merchantReturnDays": 14,
"returnMethod": "https://schema.org/ReturnByMail",
"returnFees": "https://schema.org/ReturnShippingFees"
}

Help me please !!

@patrickreiner
Copy link

Hi, apparently (according to ahrefs.com) the field "applicableCountry" is required for "MerchantReturnPolicy".

My issue is, the return policy is valid worldwide, so I cannot specify a ISO code for the country (e.g. US).

How can I tackle this?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

5 participants