Shopify Flow y GraphQL Admin API

Flow utiliza Shopify GraphQL Admin API para crear automatizaciones e integraciones que amplían y mejoran el panel de control de Shopify. Actualmente, Flow utiliza la versión 2024-07 de la API para evaluar los estados y las variables en los flujos de trabajo, así como para realizar acciones en tu tienda Shopify. Dado que Flow accede a los datos de la tienda mediante una llamada a la API, tú tienes acceso a casi todos los campos disponibles en la API desde Flow.

La mayoría de las acciones de Flow usan la API para hacer cambios en tu tienda Shopify. Por ejemplo, la acción Agregar etiquetas de pedido utiliza la mutación tagsAdd . La acción Enviar solicitud de la Admin API puede utilizar la mayoría de las mutaciones, incluidas aquellas que aún no están disponibles como acciones en Flow.

A medida que creas flujos de trabajo, a menudo encontrarás nombres de campos y descripciones basados en la API. Es posible que necesites obtener una vista previa de los datos o revisar la documentación de la API para comprender qué genera la API y qué se utiliza en Flow, así como para asegurarte de que tu flujo de trabajo genere los datos que esperas.

Gestión de versiones de la API

Shopify lanza nuevas versiones de API cada tres meses y Flow adopta nuevas versiones lo antes posible, pero podría estar detrás de la última versión. En la medida de lo posible, los cambios entre versiones se resuelven automáticamente, pero algunos pueden no ser sencillos, por ejemplo: * Cuando se eliminan campos pero no se sustituyen por otros, lo que puede afectar a la forma en que se evalúan las condiciones o el Liquid. * Cuando los campos se vuelven anulables, afectando potencialmente a cómo se evalúan las condiciones o Liquid. * Cuando cambian los valores de enum o se añaden nuevos tipos de unión o interfaz, lo que puede afectar a Liquid o al código. * Cuando cambian los argumentos de mutación, lo que puede afectar a la configuración de las acciones de solicitud de la API Send Admin.

Es posible que algunos flujos de trabajo deban actualizarse manualmente. En estos casos, es posible que los flujos de trabajo muestren un error Update required or Unsupported API y te guíen a la documentación de la API correspondiente para realizar los cambios necesarios en el editor de flujos de trabajo. Cuando se completan y guardan estas actualizaciones, el flujo de trabajo se actualiza automáticamente para utilizar la última versión de la API disponible en Flow.

Puedes optar por ignorar los problemas temporalmente para hacer cambios urgentes en un flujo de trabajo con errores de compatibilidad de la versión de la API. Si no se solucionan estos problemas, el flujo de trabajo podría dejar de ejecutarse o causar errores cuando la versión anterior de la API ya no sea compatible con Shopify.