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 Shopify se mueve rápido en 2026, y los cambios en este ciclo son mayores que la limpieza trimestral habitual. Aquí hay una mirada directa a qué se lanza, qué se rompe y dónde está la verdadera oportunidad.

Storefront API 2026-07: Qué se Rompe Antes de Octubre

Shopify Summer 2026 Edition (nombre en clave "Compass") envía 65 actualizaciones de productos, y el lanzamiento del candidato de Storefront API 2026-07 es en el que los desarrolladores necesitan enfocarse. Introduce cambios disruptivos en las estructuras de consultas de carrito y productos que afectan a cada compilación headless, ya sea que estés en Hydrogen, Next.js Commerce, Nuxt o una pila personalizada. La versión antigua de API 2024-10 se descontinúa 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 el ID de la línea del carrito para que puedas mapearlo nuevamente en tu interfaz. Si vendes en múltiples mercados, tu frontend necesita manejar estas advertencias adecuadamente 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 no disponible (después de cambios en la dirección o contenidos del carrito), el sistema cambiaba automáticamente a una opción diferente sin notificárselo a nadie. La versión 2026-07 ahora emite una advertencia DELIVERY_SELECTED_OPTION_NOT_AVAILABLE para que puedas solicitar a los compradores que confirmen o elijan una nueva opción.

Para usuarios de Hydrogen, Shopify proporciona codemods que manejan la mayoría de cambios de nombres de campos estructurales. No corregirán la lógica de descuentos personalizada, así que si tu tienda tiene precios escalonados, reglas BOGO o descuentos específicos del mercado, esa migración depende de ti.

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

Comparación de Versiones de Storefront API

Shopify Scripts Se Ha Ido. En Serio, Esta Vez.

Este se ha señalizado durante años, pero el plazo 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 aún 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 este plazo.

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 del carrito al checkout ahora incluyen soporte para tarjetas en bóveda 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 compilaciones headless durante años, donde las características de checkout autenticadas se rezagaban respecto a la experiencia estándar basada en Liquid.

Relacionado: la API de administración GraphQL ahora incluye un campo cartToken en el objeto Order, permitiendo que los desarrolladores accedan al token de carrito utilizado para crear un pedido. Esto facilita 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á Funcionando.

Este es el mayor cambio arquitectónico que vale la pena entender ahora, y reescribe algunas suposiciones sobre qué es headless.

El 11 de enero de 2026, Shopify anunció su plataforma de comercio agentico, construida sobre tres pilares: el Protocolo de Comercio Universal (UCP), un estándar abierto codesarrollado 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ó Storefronts Agenticos de forma predeterminada para cada tienda en la plataforma. Tus productos ya se están sindicando a través del Catálogo Shopify a menos que te hayas excluido.

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 Shopify ahora son descubribles en ChatGPT, Microsoft Copilot, AI Mode en Google Search y la aplicación Gemini.

UCP se codesarrolla con Google y está 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 Shopify están automáticamente listos para vender allí sin necesidad de 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 construiste alguna integración de agente de IA personalizada en la parte superior de un storefront Hydrogen, los nombres de herramientas antiguos y el endpoint se deprecian, con los nuevos efectivos el 30 de mayo y las versiones antiguas descontinuadas 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 aún tiene mérito para el rendimiento y el control de diseño. Pero ahora hay un contraargumento que importa comercialmente.

Los agentes de IA (ChatGPT, Gemini, Copilot) leen datos de catálogo estructurados y colocan órdenes sin nunca cargar tu CSS o tu frontend personalizado. Si tu pila headless vive fuera del gráfico de catálogo de Shopify, esos agentes no pueden ver tus productos. Mantenerse acoplado al plano de datos de Shopify a través de la Storefront API y el Catálogo es lo que te pone 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 en 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 rastreadores, 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 sólido para headless: GMV anual superior a $2M donde las mejoras de rendimiento tienen un impacto de ingresos medible, desarrolladores JavaScript internos o un socio de agencia a largo plazo con experiencia en Hydrogen, tiendas híbridas de contenido-comercio donde el contenido editorial y las páginas de productos se integran profundamente.
• Omítelo por ahora: Tiendas nuevas con menos de $1M. Domina tu tema Liquid primero. El techo de rendimiento en una compilación Hydrogen bien optimizada es más alto, pero el costo es aproximadamente 3-5 veces mayor que una compilación tradicional, la compatibilidad de aplicaciones requiere re-ingeniería activa (muchas aplicaciones de nivel medio en la Shopify App Store aún no ofrecen una ruta nativa headless a partir de 2026), y tu dependencia de desarrolladores se vuelve permanente.

Para marcas Shopify Plus que sí vayan headless, Hydrogen y Oxygen siguen siendo el stack recomendado. Hydrogen se construye sobre React Router, es compatible con Storefront API 2026-04 con características actuales y envía codemods alineados con el cadence de API propio de Shopify. Si tu equipo tiene experiencia profunda en Next.js, esa ruta sigue siendo viable, pero eres responsable de la integración completa de Storefront API y el alojamiento 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 de Shopify Scripts inmediatamente. El plazo del 30 de junio es firme. Pasa 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 qué ve un agente de IA. Las páginas de política faltantes, descripciones de productos delgadas y nombres de variantes poco claros se están exponiendo a los agentes ahora. Arreglarlos es más rápido y de mayor impacto que la mayoría de 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 advertencia de carrito para PRODUCT_UNAVAILABLE_IN_BUYER_LOCATION y DELIVERY_SELECTED_OPTION_NOT_AVAILABLE antes de actualizar a 2026-07.

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