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 · 5 comments
Closed

Structured product returns #2288

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

Comments

@danbri
Copy link
Contributor

@danbri 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 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

@ronnieroyston ronnieroyston commented Jul 16, 2019

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

@RichardWallis
Copy link
Contributor

@RichardWallis RichardWallis commented Jul 16, 2019

@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 danbri commented Mar 3, 2020

(See #2381 for the renaming)

@RichardWallis
Copy link
Contributor

@RichardWallis RichardWallis commented Jul 2, 2020

Implemented

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

Successfully merging a pull request may close this issue.

None yet
3 participants