show_microdata.php – Adding shipping/returns to Offer JSON-LD (ChatGPT recommend

Hi Nicolas,

I’m working in product structured data.
This is generated via this template override:

`/templates/cassiopeia/html/com_hikashop/product/show_microdata.php`

When I validate a product page with Google’s Rich Results Test, the page is valid, but I consistently get **non-critical Merchant listings warnings under `offers`**:

* Missing field `hasMerchantReturnPolicy` (optional)
* Missing field `shippingDetails` (optional)

A practical approach was suggested to me by ChatGPT to “polish” shipping and returns for Google Merchant listings: implement these fields **server-side** in the Offer JSON-LD that HikaShop outputs (instead of injecting them with JavaScript after load, which doesn’t seem to be reliably picked up by Google’s test).

**Goal**
Add `hasMerchantReturnPolicy` (and later `shippingDetails`) inside each `Offer` object that HikaShop generates (variants) in `show_microdata.php`, so Google can read it reliably and these warnings disappear.

**Return policy requirements / constraints**

* Public return policy page: ` www.hermanosgaliano.es/devoluciones `
* General return window: **15 days**
* For **personalized products**, returns are **not permitted** (except manufacturing defects; details are on the policy page)
* We can detect personalized products by URL/alias containing the substring `personaliz` (plus one specific exception slug)

**Proposed implementation (high level)**
In `show_microdata.php`, where `$variant_offer` is built (Offer JSON-LD), add something like:

* `hasMerchantReturnPolicy`:

* `@type: MerchantReturnPolicy`
* `applicableCountry: ES`
* `merchantReturnLink: www.hermanosgaliano.es/devoluciones `
* `returnPolicyCategory`:

* `MerchantReturnNotPermitted` for personalized products
* `MerchantReturnFiniteReturnWindow` + `merchantReturnDays: 15` for non-personalized products

Then attach it to the offer:
`$variant_offer->hasMerchantReturnPolicy = $rp;`

**Questions**

1. Is editing/augmenting `show_microdata.php` (override) the recommended/supported way to extend the Offer JSON-LD in HikaShop, or is there a built-in config/hook/plugin mechanism you’d recommend instead?
2. Does the use of `MerchantReturnPolicy` inside `Offer` align with HikaShop’s schema output and Google’s Merchant listings expectations, in your experience?
3. For `shippingDetails`, is there a preferred best-practice approach in HikaShop (global shipping policy vs per-offer `shippingDetails`) that you recommend?

If you want, I can paste the exact excerpt from `show_microdata.php` where `$variant_offer` is created, so you can advise the cleanest placement.

Thanks a lot,
José Ángel