Obtener datos de sucursales

En los flujos de trabajo que requieren datos de sucursales, usa la acción Obtener datos de sucursales para recuperar información de las sucursales de la tienda Shopify. Con Locations se hace referencia a cualquier lugar donde se almacena inventario, se venden productos o se envían o preparan pedidos.

Nota

Esta es una acción del tipo Obtener datos. Para entender cómo usar este tipo de acción con el activador Hora programada y los bucles Para cada, consulta Schedules, get data, and looping workflows in Shopify Flow.

Configuración

Campos

La acción Obtener datos de sucursales incluye los siguientes campos.

Campos usados en las acciones Obtener datos.

Campo	Descripción
Ordenar datos por	Obligatorio. Los parámetros por los que se ordenan los datos que devuelve la consulta de búsqueda.
Número máximo de resultados	Obligatorio. La cantidad máxima de resultados que puede devolver la consulta de búsqueda que selecciones. Puedes obtener hasta 100 a la vez.
Consulta	Obligatorio. Elige entre consultas comunes o selecciona la opción Avanzada para crear la tuya.

Cadena de consulta

Esta es una consulta de ejemplo para obtener sucursales que tienen habilitado el retiro en tienda:

pickup_in_store:enabled

La variable pickup_in_store es un filtro disponible en Locations query y se puede usar varias veces o combinar con otras variables.

Cuando consultas datos, conviene saber lo siguiente:

• List of available location filters

• Las consultas deben seguir una certain syntax

• No siempre se documentan los valores de los campos de la consulta. En algunos casos, puedes encontrarlos en la API docs. También suele ser posible verlos en las URL del panel de control cuando aplicas un filtro. Por ejemplo, para ver algunos valores de consulta de Pedidos, filtra la página Pedidos en el panel de control y luego revisa la URL.

• Puedes ejecutar o probar una consulta en la tienda con Shopify GraphiQL app.

• Ten en cuenta qué pasa si la consulta falla. Con frecuencia, la API devuelve todos los resultados (en lugar de ninguno).

Datos devueltos

Todas las acciones de Obtener datos devuelven una lista de entre 0 y 100 recursos. Según el caso de uso, puedes usar estos datos de distintas maneras:

• Si necesitas procesar cada elemento de la lista por separado, por ejemplo para agregar una etiqueta a cada uno, usa la acción For each.
• Si necesitas agregar datos, como contar cuántos resultados se devolvieron, usa las acciones Count o Sum.
• Si necesitas mostrar la lista, por ejemplo enviar un correo electrónico con todos los elementos, puedes usar los datos devueltos directamente en las acciones siguientes.

Para acceder a los datos devueltos en los pasos que siguen a esta acción, usa la variable llamada Obtener datos de sucursales, que es una lista de sucursales. Puedes usar esta variable tanto en condiciones como en acciones. Por ejemplo, puedes enviar la lista de sucursales en una acción de Enviar correo electrónico interno así:

{% for single_location in GetLocationData %}
* {{ single_location.id }}
{% endfor %}

Nota

Si usas una acción de Obtener datos varias veces en un mismo flujo de trabajo, se añade un número al nombre de la variable. Por ejemplo, en un flujo de trabajo que usa dos veces la acción Obtener datos de pedidos, la primera variable de datos devueltos es getOrderData y la segunda es getOrderData1. Este nombre no se puede personalizar.

Activadores

Puedes usar esta acción en cualquier flujo de trabajo, incluido el activador Hora programada. En un flujo de trabajo que usa el activador Hora programada, el flujo se inicia en la hora que especifiques, en lugar de como resultado de un evento. Como no hay un evento específico en la tienda ni de una aplicación que inicie el flujo, no se incluye ningún dato automáticamente.

Referencia de la API

Para obtener más información sobre la API usada en esta acción, consulta Locations query.