¿Qué es MerchantReturnPolicy en Schema.org?

Tu tienda ya tiene una política de devoluciones: una página con plazos, condiciones y quién paga el envío de vuelta. MerchantReturnPolicy es esa misma política escrita en datos estructurados, con un vocabulario cerrado que una máquina puede leer sin interpretar frases. Es un tipo de Schema.org y se escribe en inglés porque es un nombre del vocabulario. No sustituye a tu página de devoluciones: la resume para un buscador. Te importa porque, según Google, con este marcado la Búsqueda puede mostrar tu política de devoluciones junto a tus productos y en los paneles de conocimiento.⁠^{[1]Google Search Central. Merchant return policy (MerchantReturnPolicy) structured data}

Cómo funciona

Schema.org define MerchantReturnPolicy como la información sobre las políticas de devolución de productos asociadas a una organización, un producto o una oferta.⁠^{[2]Schema.org. MerchantReturnPolicy} Google simplifica esas tres opciones a dos niveles. La política general de la tienda va en el nodo de la organización, con la propiedad hasMerchantReturnPolicy, y Google recomienda ponerla en una sola página de tu web que describa tu política de devoluciones: no hace falta repetirla en todas. La de un producto concreto va en su oferta, solo cuando ese producto tiene condiciones distintas, y admite menos propiedades que la de la organización.⁠^{[1]Google Search Central. Merchant return policy (MerchantReturnPolicy) structured data} La entrada de Organization enseña dónde se cuelga la general, y la de Offer, dónde va la de un producto.

Ese reparto es reciente. Google admite la política a nivel de organización desde el 11 de junio de 2024; el 10 de junio de 2025 le dio una página de documentación propia; y el 11 de julio de 2025 aclaró que la política de una oferta solo admite una parte de las propiedades y que la política general tiene que ir en el nodo de la organización.⁠^{[3]Google Search Central. Latest documentation updates}

Para Google hay dos maneras de cumplir lo obligatorio. La primera es dar el país donde se aplica la política (applicableCountry, en código de dos letras, hasta 50 países) y su tipo (returnPolicyCategory), que tiene tres valores: plazo limitado (MerchantReturnFiniteReturnWindow, y entonces hace falta merchantReturnDays, los días desde la entrega), devoluciones no admitidas (MerchantReturnNotPermitted) y plazo ilimitado (MerchantReturnUnlimitedWindow). La segunda es dar solo el enlace a la página que describe la política, con merchantReturnLink, sea la tuya o la de un servicio que gestiona tus devoluciones.⁠^{[1]Google Search Central. Merchant return policy (MerchantReturnPolicy) structured data}

El resto son recomendadas, y son las que hacen útil el marcado:⁠^{[1]Google Search Central. Merchant return policy (MerchantReturnPolicy) structured data}

Hay también un cargo de reposición (restockingFee) y excepciones por temporada (returnPolicySeasonalOverride), por ejemplo un plazo distinto durante las fiestas.⁠^{[1]Google Search Central. Merchant return policy (MerchantReturnPolicy) structured data}

Lo que más sorprende es el orden de preferencia. Google combina varias fuentes y aplica la más fuerte: primero la Content API for Shopping, después la configuración de devoluciones de Google Merchant Center o de Search Console, después el marcado del producto y, al final, el de la organización. Si tienes marcado y además configuras devoluciones en Search Console, Google solo usa lo de Search Console.⁠^{[1]Google Search Central. Merchant return policy (MerchantReturnPolicy) structured data} Entre los dos marcados, si das los dos, gana el del producto.⁠^{[4]Google Search Central. Merchant listing (Product, Offer) structured data}

En una tienda

Lo que importa para el marcado es que diga lo mismo que tu página, y tu página, lo que tu tienda hace de verdad.

Ejemplo ficticio. Una tienda española inventada publica esta política: 30 días desde la entrega, devolución por correo, el envío de vuelta lo paga el cliente salvo que el producto llegue defectuoso, y reembolso completo. Las camisas bordadas con iniciales no se pueden devolver. Así se traduce:

{
  "@context": "https://schema.org",
  "@type": "Organization",
  "@id": "https://www.example.com/#organization",
  "name": "Calella",
  "hasMerchantReturnPolicy": {
    "@type": "MerchantReturnPolicy",
    "applicableCountry": ["ES", "PT"],
    "returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow",
    "merchantReturnDays": 30,
    "returnMethod": "https://schema.org/ReturnByMail",
    "returnFees": "https://schema.org/ReturnFeesCustomerResponsibility",
    "itemDefectReturnFees": "https://schema.org/FreeReturn",
    "refundType": "https://schema.org/FullRefund"
  }
}

La camisa bordada lleva en su oferta una política propia con MerchantReturnNotPermitted, que gana a la general para ese producto.⁠^{[4]Google Search Central. Merchant listing (Product, Offer) structured data} Y si un día la tienda configura sus devoluciones en Search Console, ese marcado deja de ser lo que Google usa.⁠^{[1]Google Search Central. Merchant return policy (MerchantReturnPolicy) structured data}

Cómo comprobarlo

1. Busca hasMerchantReturnPolicy en el código fuente de la página donde está tu nodo de organización, y anota el país, el tipo de política y los días.⁠^{[1]Google Search Central. Merchant return policy (MerchantReturnPolicy) structured data}
2. Compáralo con tu página de devoluciones, frase por frase: el plazo, quién paga el envío de vuelta y el tipo de reembolso tienen que coincidir.
3. Busca políticas dentro de las ofertas de tus fichas. Cada una tiene que corresponder a un producto con condiciones distintas, porque gana a la general.⁠^{[4]Google Search Central. Merchant listing (Product, Offer) structured data}
4. Mira si tienes devoluciones configuradas en Merchant Center o en Search Console. Si las tienes, son las que usa Google y es ahí donde hay que mantenerlas al día.⁠^{[1]Google Search Central. Merchant return policy (MerchantReturnPolicy) structured data}
5. Comprueba qué resultados enriquecidos detecta Google: pasa la URL por la Prueba de resultados enriquecidos y mira qué encuentra y con qué errores o advertencias.⁠^{[1]Google Search Central. Merchant return policy (MerchantReturnPolicy) structured data}

Concepto cercano: política de devoluciones

La política de devoluciones es el documento: lo que prometes al cliente, con su letra pequeña y sus excepciones. MerchantReturnPolicy es su resumen en un vocabulario de valores cerrados. La política se redacta para personas; el marcado la traduce a valores que una máquina puede comparar. El orden nunca se invierte: primero se decide y se publica la política, y después se marca exactamente lo que dice. La política de devoluciones tiene su propia entrada.

Para seguir, la ruta de lectura de datos estructurados ordena el resto de términos, y la entrada de OfferShippingDetails hace lo mismo con los envíos.