Migración de WooCommerce a Merchant API

Google apagó la Content API for Shopping el 18 de agosto de 2026. Desde esa fecha, cada llamada a los antiguos endpoints v2.1 vuelve como HTTP 410 Gone, y cualquier integración todavía apuntada hacia ellos ya no envía productos, precios ni stock a Google Merchant Center. La buena noticia, que la mayoría de las publicaciones alarmistas se saltaron, es que una gran parte de las tiendas WooCommerce no tenía nada que hacer, y que comprobar en qué grupo estás lleva unos minutos.

La versión honesta de esta historia sigue siendo un triaje, no una emergencia. En WPPoland construimos y mantenemos integraciones de WooCommerce para comerciantes que venden por toda la UE, así que aquí está a quién afecta de verdad, qué deja de funcionar en una tienda que no llegó a la fecha y por qué la misma migración es, en silencio, la puerta al comercio impulsado por agentes.

#Cuándo se apagó la Content API for Shopping

La Content API for Shopping era la superficie programática de Google para gestionar todo lo que una tienda envía a Merchant Center: datos de producto, inventario, precios y ajustes de cuenta. La ha sustituido la Merchant API, que cubre el mismo terreno pero está dividida en subAPI enfocadas (Products, Inventories, Accounts, Reports) en lugar de un endpoint monolítico.

La fecha que importaba era el 18 de agosto de 2026. Desde entonces, la antigua Content API devuelve 410 Gone y no vuelve. Antes hubo otra fecha: la v1beta de la Merchant API se retiró el 28 de febrero de 2026, así que el código escrito contra la beta también quedó fuera de juego y tiene que estar en la v1 estable.

#Qué tiendas WooCommerce deben migrar a la Merchant API

Esta es la pregunta que decide si puedes cerrar esta pestaña. Una tienda WooCommerce suele hablar con Merchant Center de tres formas.

• El plugin oficial Google for WooCommerce. Si tu sincronización de productos corre a través del plugin oficial (antes Google Listings and Ads), estás cubierto. Google y WooCommerce entregaron el cambio a la Merchant API dentro de una versión del plugin, así que una actualización normal te llevó al otro lado sin código. Comprueba en Plugins que estás en una versión reciente y que la sincronización sigue registrando envíos.
• Un plugin de feed o de marketing de terceros. Algunos de estos llamaban a la Content API directamente. Confirma con el proveedor que ya publicó la versión que habla con la Merchant API y que tu instalación está en ella.
• Una integración propia. Conectores a medida, exportadores de feed propios, montajes headless que envían a Merchant Center desde tu propio código y herramientas internas escritas contra la Content API. Este es el grupo con trabajo real, y si nadie tocó ese código, es también el grupo cuyo feed ya no llega a Merchant Center.

En el mercado español se suma aquí un caso típico: una tienda que con un único exportador propio alimenta a la vez Google Merchant Center e Idealo ES. Google es entonces solo uno de varios canales en ese script, así que la migración de esa única rama a la Merchant API debe hacerse sin tocar los demás feeds, que siguen funcionando como antes.

Si estás en el primer grupo, para aquí. Si estás en el tercero, lo primero es mirar los registros: una respuesta 410 Gone desde los endpoints v2.1 confirma que la integración ya no sincroniza, y en Merchant Center lo verás como un catálogo que no se mueve desde mediados de agosto.

#El feed de Merchant Center no se actualiza

Nada se degrada con suavidad. Desde el 19 de agosto de 2026 las llamadas simplemente fallan con 410 Gone, y los efectos se encadenan:

• Las fichas se quedan obsoletas. Los productos nuevos dejan de aparecer, y los eliminados pueden quedarse colgados. Tu catálogo en Merchant Center se aleja de tu catálogo real de WooCommerce.
• Precios y stock dejan de actualizarse. Este es el peligroso. Merchant Center sigue mostrando el último precio y la última disponibilidad que recibió, así que puedes acabar anunciando un precio que ya no cobras o un producto que ya no tienes en stock, lo que arriesga rechazos y pérdida de confianza de la cuenta.
• Las campañas Shopping y Performance Max pasan hambre. Las campañas de Google Ads se alimentan de los datos de producto de Merchant Center. Cuando el feed se congela, las campañas corren sobre inventario caducado hasta que, en silencio, empiezan a rendir mal.

Como falla todo de golpe en lugar de avisarte, una tienda puede llevar días publicando datos viejos sin que nadie lo note. Si sospechas que es tu caso, trata la revisión del feed como lo urgente y la migración como lo siguiente en la lista.

Google indica en la ayuda de Merchant Center que las actualizaciones automáticas no sustituyen las actualizaciones periódicas de los datos de producto. Sirven solo para corregir problemas esporádicos de precio, disponibilidad y estado. Si esperas que el precio, la disponibilidad y el estado de tus productos cambien con frecuencia, Google dice que debes usar la Merchant API. En una tienda con stock de rotación rápida, esto significa enviar los cambios desde la integración, en lugar de esperar a que Google corrija los datos a partir de tus páginas.

#Cómo migrar una integración de WooCommerce a la Merchant API

El trabajo es metódico más que difícil, y es ingeniería de WooCommerce corriente del lado del servidor.

• Confirma primero el estado real. Busca respuestas 410 en los registros de la integración y compara la fecha del último producto sincronizado en Merchant Center con tu catálogo de WooCommerce. Eso te dice cuántos días de datos caducados hay que corregir.
• Inventaría tus llamadas de la Content API. Enumera cada endpoint que toca tu integración y el evento de WooCommerce que lo dispara (guardado de producto, cambio de stock, sincronización completa programada).
• Asigna cada llamada a su subAPI de la Merchant API. Products, Inventories, Accounts y Reports asumen, cada una, parte de lo que la Content API hacía en un solo sitio.
• Vuelve a autenticarte. La Merchant API usa OAuth 2.0 o una cuenta de servicio. Confirma que tus credenciales y ámbitos se trasladan.
• Revisa las etiquetas del feed tras el cambio. La configuración de etiquetas no siempre sobrevive al cambio, y las etiquetas gobiernan la estructura de las campañas, así que verifícalas en lugar de darlas por sentadas.
• Obtén los motivos de rechazo agregados desde la subAPI Reports en cuanto la nueva integración esté funcionando, para atrapar todo lo que el cambio haya alterado antes de que lo hagan los algoritmos de Google.

#Merchant API y MCP para agentes de compra con IA

Ver la migración como una tarea pesada pierde el sentido. El cambio a la Merchant API abre también el Merchant API MCP Access Service, un puente alpha que expone los datos de Merchant Center a LLM y agentes de IA a través del Model Context Protocol, de momento solo lectura más unas pocas herramientas de escritura de bajo riesgo. En pocas palabras: la misma plataforma en la que ahora vive tu feed de productos es aquella de la que leerán los asistentes de compra de IA cuando decidan qué productos mostrar.

Eso conecta el apagado con el cambio mayor sobre el que venimos escribiendo: las tiendas pasan de ser navegadas por personas a ser consultadas por agentes. La migración que había que hacer de todas formas es, a la vez, la rampa de acceso para ser encontrable y comprable por esos agentes, que es toda la tesis de nuestra guía de preparación para el comercio con IA.

Atributos conversacionales, actualización del 23 de octubre de 2026: desde Google Marketing Live en mayo de 2026, la especificación de datos de producto de Merchant Center tiene seis campos opcionales pensados para el Modo IA y superficies de IA parecidas. La página de ayuda de Google sobre atributos conversacionales los enumera: question_and_answer (preguntas y respuestas sobre el producto, hasta 1000 caracteres cada una), document_link (manuales en PDF, guías de uso, instrucciones de montaje), related_product (accesorios, piezas necesarias, sustitutos), item_group_title y variant_option (un título común para una familia de productos y las características que distinguen las variantes) y popularity_rank (un número de 0 a 100 que sitúa el producto frente al resto de tu catálogo). Google recomienda enviarlos con una fuente de datos complementaria, asegura que no cambian el estado de aprobación de los productos existentes y pide no repetir lo que ya está en description, product_highlight o product_detail. Las columnas son las mismas genere quien genere el feed: un plugin de WooCommerce, una app de feeds en una tienda en Shopify o una exportación propia. La fuente más barata es el contenido que ya tienes, como las preguntas frecuentes del producto y los manuales en PDF enlazados en las fichas.

#Por qué Google muestra un precio de oferta que no está en el feed de WooCommerce

Una sincronización con la Merchant API que funciona le dice a Google lo que la tienda envía hoy. Pero Google guarda su propio registro de lo que vio antes. Emina Demiri-Watson describió el 5 de octubre de 2026 en Search Engine Journal una tienda británica en la que Google mostraba en Shopping Was £474, now £355 con una insignia de oferta. La tienda no tenía ninguna oferta y nunca envió el atributo sale_price, ni en el feed actual ni en los anteriores. Tres señales sumaron la insignia:

• el feed enviaba £355 como precio sin IVA, mientras que el último rastreo de la página leyó £426, el mismo precio con IVA,
• el marcado Product era un AggregateOffer con dos niveles de priceSpecification, List price a £395 y Sale price a £355, y £395 sin IVA son £474 con IVA,
• el HTML de la página escribía Now junto al precio, y una exportación del feed del 15 de abril aún llevaba £474 en el campo de precio.

Ninguna de estas señales pedía una insignia por sí sola. La autora lo resume en dos frases: “La gente olvida. Los sistemas no” (Emina Demiri-Watson, Search Engine Journal, traducción propia).

Las insignias que la tienda pide con sale_price tienen sus propias condiciones. Google comprueba que el descuento esté entre el 5% y el 90% y que el precio base se haya enviado durante un periodo mínimo, en Reino Unido “al menos 30 días dentro de los últimos 200 días” (Emina Demiri-Watson, Search Engine Journal, traducción propia). Las anotaciones de bajada de precio ni siquiera requieren envío: Google compara el precio actual con la media que él mismo registró en los últimos 60 días. El tamaño de esa memoria, según el mismo artículo: el Shopping Graph contiene “más de 50.000 millones de fichas de producto, de las que más de 2.000 millones se actualizan cada hora” (Emina Demiri-Watson, Search Engine Journal, traducción propia).

En una tienda española solo cambia la cifra. Para un producto al tipo general del 21%, el precio rastreado queda un 21% por encima del precio del feed cuando el feed envía el precio sin IVA y la página lo muestra con IVA. Los productos a tipos reducidos (10% o 4%) dan otras diferencias. Una tienda con tipos mezclados no verá, por tanto, una única diferencia en todo el catálogo.

#Cómo comparar el precio del feed con el precio del schema Product en WooCommerce

• Empieza por lo que vio Google. En Merchant Center abre el producto en Products > All products (nombres de la interfaz en inglés) y baja hasta el final de la pestaña Product details. La sección Information found on your site muestra el precio que Google leyó de la página la última vez, con la fecha. Si la diferencia es igual al tipo de IVA, el feed envía sin IVA y la página muestra con IVA.
• Revisa WooCommerce > Settings > Tax. La opción de introducir precios con impuestos decide qué significa el precio guardado, y la de mostrar precios en la tienda decide si el cliente lo ve con o sin IVA. Compáralo con lo que envía tu exportador del feed. Si la página muestra con IVA y el feed sin IVA, Google tiene que deducir el impuesto por su cuenta.
• Lee el JSON-LD que sale en la página, no la pantalla de ajustes. Abre el código fuente de una ficha de producto y busca cada bloque application/ld+json con un Product. WooCommerce genera su propio marcado Product, y un plugin de SEO puede añadir un segundo que no coincide. Busca un segundo precio y nombres en priceSpecification con Sale o List.
• Busca palabras de oferta en el HTML. WooCommerce pone el precio normal en <del> y el rebajado en <ins> cuando el producto tiene precio rebajado, y los temas suelen añadir etiquetas como “Antes” y “Ahora”. Si un producto sin oferta muestra alguna, cambia la etiqueta. La autora aconseja lo mismo.
• Guarda exportaciones del feed con fecha. El caso británico se resolvió porque había, por casualidad, una exportación de abril guardada. Una exportación al mes convierte la siguiente investigación en una comparación de dos archivos.

#Qué hacer con las imágenes de productos retirados en WooCommerce

Google mantiene su propio índice de imágenes de producto, independiente de image_link en el feed y del schema. Mientras una URL antigua de imagen siga respondiendo, Google puede seguir usando esa imagen en anuncios y fichas gratuitas, aunque la tienda la haya cambiado hace tiempo. El artículo menciona WooCommerce directamente: “las subidas de WooCommerce están en la biblioteca de medios estándar de WordPress y rara vez se limpian cuando se retiran los productos” (Emina Demiri-Watson, Search Engine Journal, traducción propia).

• Borrar un producto no borra sus imágenes. Cuando retires un producto o cambies una foto, borra el adjunto antiguo en Media > Library con Delete permanently. WordPress elimina el archivo y los tamaños generados, y la URL antigua devuelve 404, la señal limpia que recomienda el artículo. Comprueba antes que ningún otro producto o página usa esa imagen.
• Un nombre de archivo nuevo deja el antiguo en línea. Una foto subida con otro nombre le da a Google dos URL de imagen para un producto, y Google no siempre elige la actual.
• Confirma el 404 en la propia URL. Abre la dirección antigua de la imagen después de borrarla. Una CDN o la caché de la página pueden seguir sirviendo el archivo después de que WordPress lo haya eliminado.
• Busca el nombre antiguo del archivo en Google Imágenes. Una copia en un marketplace o en una página ajena olvidada puede ser el origen de la imagen equivocada, y esa copia hay que retirarla donde está.

#Qué hacer si tu feed de WooCommerce se paró

Si usas el plugin oficial, comprueba que está en una versión reciente y que el último envío a Merchant Center es de estos días, y sigue con tu día. Si tienes una integración propia o de terceros que aún apunta a la Content API, el feed ya no se actualiza: revisa antes que nada las campañas que dependen de él para no seguir anunciando precios y stock caducados, averigua de qué subAPI dependes y prueba la nueva integración contra una cuenta no productiva antes de dirigir tráfico real, que es justo lo que Google recomienda.

Nos encargamos de estas migraciones como parte de nuestro trabajo de desarrollo WooCommerce, junto al lado analítico de los pedidos impulsados por agentes, que tratamos en qué pasa cuando un agente de IA finaliza la compra, y el servidor MCP para WooCommerce de solo lectura, que muestra cómo leen los agentes un catálogo, para empezar.

Última actualización: 11 de octubre de 2026.