Shopify Headless y Storefront API: Qué ha cambiado realmente y por qué importa

Si has estado usando una versión de Storefront API de 2024, el reloj está corriendo. La plataforma de Shopify se mueve rápido en 2026, y los cambios de este ciclo son más grandes que la limpieza trimestral habitual. Aquí tienes una visión fundamentada de qué se lanza, qué se rompe y dónde está la verdadera oportunidad.

Storefront API 2026-07: Qué se rompe antes de octubre

Shopify's Summer 2026 Edition (codename "Compass") envía 65 actualizaciones de producto, y el lanzamiento del candidato de Storefront API 2026-07 es en el que los desarrolladores deben enfocarse. Introduce cambios disruptivos en las estructuras de consulta de carrito y productos que afectan a cada construcción headless, ya sea que estés en Hydrogen, Next.js Commerce, Nuxt o un stack personalizado. La versión antigua 2024-10 se retira en octubre de 2026, dando a los equipos una ventana de cinco meses para migrar.

Dos cambios en particular merecen atención inmediata:

• Advertencia PRODUCT_UNAVAILABLE_IN_BUYER_LOCATION. A partir de 2026-07, el objeto Cart emite una advertencia PRODUCT_UNAVAILABLE_IN_BUYER_LOCATION cuando una línea del carrito contiene un producto que no está disponible en la ubicación del comprador. Cada línea de carrito afectada devuelve su propia advertencia, con un destino establecido en la ID de línea de carrito para que puedas asignarlo en tu interfaz. Si vendes en múltiples mercados, tu frontend debe manejar esto apropiadamente en lugar de ocultar productos silenciosamente.
• Advertencia DELIVERY_SELECTED_OPTION_NOT_AVAILABLE. Anteriormente, si la opción de entrega elegida por un comprador se volvía indisponible (después de que cambiara la dirección del carrito o el contenido), el sistema cambiaría automáticamente a una opción diferente sin notificar a nadie. La versión 2026-07 ahora emite una advertencia DELIVERY_SELECTED_OPTION_NOT_AVAILABLE para que puedas pedir a los compradores que confirmen u elijan una nueva opción.

Para usuarios de Hydrogen, Shopify envía codemods que manejan la mayoría de los cambios de nombres de campos estructurales. No arreglarán la lógica de descuento personalizada, así que si tu tienda tiene precios por niveles, reglas BOGO o descuentos específicos del mercado, esa migración corre por tu cuenta.

También vale la pena notar: los enums PRIVATE y PUBLIC_READ de metaobjetos se eliminan en 2026-07. Reemplázalos antes del 1 de julio si los estás usando.

Shopify Scripts desapareció. En serio, esta vez.

Esto ha sido señalizado durante años, pero la fecha límite ahora es real. A partir del 15 de abril de 2026, ya no puedes crear, editar o publicar Shopify Scripts. Después del 30 de junio de 2026, los Scripts dejan de ejecutarse completamente. Si tu tienda todavía depende de Scripts basados en Ruby para descuentos personalizados, reglas de artículos de línea o lógica de envío, la ruta de migración es Shopify Functions o una aplicación pública. No hay extensión en esta fecha límite.

Flujos de autenticación mejorados para checkouts headless

Una actualización más silenciosa pero importante del registro de cambios reciente: los flujos de autenticación mejorados desde el carrito al checkout ahora incluyen soporte para tarjetas guardadas y crédito de tienda, mejorando la experiencia del comprador específicamente para storefronts headless. Esto cierra una brecha que ha causado fricción en construcciones headless durante años, donde las características de checkout autenticadas se retrasaban con respecto a la experiencia basada en Liquid estándar.

Relacionado: la GraphQL Admin API ahora incluye un campo cartToken en el objeto Order, permitiendo a los desarrolladores acceder al token de carrito utilizado para crear una orden. Esto hace que sea más fácil rastrear el embudo completo desde una sesión de carrito headless hasta el registro de cumplimiento.

El comercio agentico no es una tendencia futura. Ya está en funcionamiento.

Este es el mayor cambio arquitectónico que vale la pena entender en este momento, y reescribe algunas suposiciones sobre lo que significa headless.

El 11 de enero de 2026, Shopify anunció su plataforma de comercio agentico, construida sobre tres pilares: el Universal Commerce Protocol (UCP), un estándar abierto desarrollado conjuntamente con Google; servidores Storefront MCP por tienda; y un Plan agentico para marcas que aún no están en Shopify. A finales de marzo de 2026, Shopify activó Agentic Storefronts por defecto para cada tienda en la plataforma. Tus productos ya están siendo sindicados a través del Shopify Catalog a menos que hayas optado por no participar.

Los números detrás de esto son significativos. Desde enero de 2025, el tráfico impulsado por IA a tiendas Shopify ha crecido 8 veces año tras año, mientras que los pedidos de búsquedas impulsadas por IA han aumentado 15 veces. Los comerciantes de Shopify ahora son descubribles en ChatGPT, Microsoft Copilot, AI Mode en Google Search y la aplicación Gemini.

UCP está codesarrollado con Google y respaldado por Amazon, American Express, Etsy, Mastercard, Meta, Microsoft, Salesforce, Stripe, Target, Walmart y Visa. Cuando una nueva plataforma de IA adopta UCP, los comerciantes de Shopify están automáticamente listos para vender allí sin ninguna integración adicional. El protocolo cubre creación de carrito, checkout, pago y post-compra en cualquier plataforma y procesador de pagos.

El 22 de abril de 2026, Shopify también cambió el servidor Storefront Catalog MCP para implementar UCP. Si has construido cualquier integración de agente de IA personalizado sobre un storefront Hydrogen, los nombres de herramientas antiguos y el endpoint son deprecados, con los nuevos efectivos el 30 de mayo y versiones antiguas retiradas el 15 de junio.

Qué significa esto para la arquitectura headless

Aquí es donde la conversación se vuelve interesante. El argumento clásico para headless era: desacopla todo para máxima flexibilidad. Ese argumento todavía tiene mérito para rendimiento y control de diseño. Pero ahora hay un contra-argumento que importa comercialmente.

Los agentes de IA (ChatGPT, Gemini, Copilot) leen datos de catálogo estructurado y realizan pedidos sin cargar nunca tu CSS o tu frontend personalizado. Si tu stack headless existe fuera del gráfico de catálogo de Shopify, esos agentes no pueden ver tus productos. Mantenerse acoplado al plano de datos de Shopify vía la Storefront API y Catalog es lo que te coloca en embudos de compra mediados por IA.

Límites de velocidad: bots y agentes ahora tratados diferentemente

Shopify ahora aplica límites de velocidad más estrictos a bots y agentes que acceden a la Storefront API y páginas de tienda en línea alojadas por Shopify. Los bots y agentes que no firman sus solicitudes están sujetos a los límites más estrictos. Para calificar para límites de velocidad más altos, los operadores necesitan firmar solicitudes con Web Bot Auth. Si ejecutas crawlers, agentes de IA o cualquier herramienta automatizada contra tu storefront, regístrate y firma tus solicitudes ahora.

¿Quién debería realmente ir headless en 2026?

Headless no es correcto para cada comerciante, y la respuesta honesta no ha cambiado mucho:

• Caso fuerte para headless: GMV anual superior a 2 millones de dólares donde las mejoras de rendimiento tienen un impacto de ingresos medible, desarrolladores de JavaScript internos o un socio de agencia a largo plazo con experiencia en Hydrogen, tiendas de contenido-comercio híbridas donde el contenido editorial y las páginas de productos están profundamente integrados.
• Sáltalo por ahora: Tiendas nuevas facturando menos de 1 millón. Domina tu tema Liquid primero. El techo de rendimiento en una construcción de Hydrogen bien optimizada es más alto, pero el costo es aproximadamente 3-5 veces el de una construcción tradicional, la compatibilidad de aplicaciones requiere re-ingeniería activa (muchas aplicaciones de nivel medio en la Shopify App Store todavía no ofrecen una ruta de integración nativa para headless a partir de 2026), y tu dependencia de desarrolladores se vuelve permanente.

Para marcas Shopify Plus que sí van headless, Hydrogen y Oxygen siguen siendo el stack recomendado. Hydrogen está construido sobre React Router, soporta Storefront API 2026-04 con características actuales, y envía codemods alineados con el ritmo de API de Shopify. Si tu equipo tiene experiencia profunda en Next.js, ese camino sigue siendo viable, pero eres responsable de la integración de Storefront API completamente y el hosting de Oxygen no está disponible.

La lista de verificación práctica

Aquí está lo que debes hacer este mes:

1. Audita tu versión actual de API. Documenta cada lugar donde codificas una cadena de versión. Si estás en 2024-10, tienes hasta octubre. Comienza a probar contra 2026-07 en staging ahora.
2. Migra fuera de Shopify Scripts inmediatamente. La fecha límite del 30 de junio es firme. Cambia a Shopify Functions.
3. Prueba tu endpoint de Storefront MCP en una tienda de desarrollo. Ejecuta una búsqueda de producto real y lee exactamente lo que un agente de IA ve. Las páginas de políticas faltantes, descripciones de productos delgadas y nombres de variantes poco claros se están exponiendo a agentes en este momento. Arreglarlo es más rápido e impactante que la mayoría de las características del roadmap.
4. Firma solicitudes de bot con Web Bot Auth si ejecutas cualquier herramienta automatizada contra la Storefront API.
5. Añade manejadores de advertencias de carrito para PRODUCT_UNAVAILABLE_IN_BUYER_LOCATION y DELIVERY_SELECTED_OPTION_NOT_AVAILABLE antes de actualizar a 2026-07.

Las tiendas que se quedarán atrás en 2026 no serán las que eligieron el marco incorrecto. Serán las que ignoraron el changelog hasta octubre.