Obtener datos de sucursal

En los flujos de trabajo que requieren datos de ubicación, puedes utilizar la acción Obtener datos de ubicación para recuperar la información de ubicación de tu tienda Shopify. Las ubicaciones son cualquier lugar en el que almacenes inventario, vendas productos o envíes o prepares pedidos.

Nota

Este es un tipo de acción Obtener datos. Para comprender cómo se utiliza este tipo de acción con el activador Hora programada y Para cada bucle, consulta esta guía.

Configuración

Campos

La acción Obtener datos de sucursal contiene los siguientes campos:

Campos utilizados en las acciones Obtener datos.

Campo	Descripción
Ordenar datos por	Obligatorio. Los parámetros con que se ordenan los datos obtenidos por la consulta de búsqueda.
Cantidad máxima de resultados	Obligatorio. La cantidad máxima de resultados que puede mostrar la consulta de búsqueda que selecciones. Puedes mostrar hasta 100 a la vez.
Consulta	Obligatorio. Elige entre las consultas comunes o selecciona Avanzada para crear la tuya.

Cadena de consulta

Este es un ejemplo de consulta para obtener sucursales que tengan habilitada la recogida en tienda:

pickup_in_store:enabled

La variable pickup_in_store es un filtro disponible en la consulta de Sucursales y puede utilizarse varias veces o combinarse con otras variables.

Cuando se consultan datos, es útil saber lo siguiente:

• Lista de filtros de sucursales disponibles

• Las consultas deben seguir una sintaxis determinada.

• Los valores de campo de consulta no siempre se documentan. En algunos casos, los valores se pueden encontrar si se revisan los documentos de la API. O bien, a menudo puedes encontrarlos en las URL en el panel de control cuando filtras. Por ejemplo, para encontrar algunos valores de consulta de pedidos, filtra la página Pedidos en el panel de control y luego verifica la URL.

• Puedes ejecutar o probar una consulta en la tienda mediante la aplicación Shopify GraphiQL.

• Ten cuidado con lo que sucede si falla la consulta. A menudo, la API mostrará todos los resultados (en lugar de ninguno).

Datos obtenidos

Todas las acciones Obtener datos muestran una lista de 0 a 100 recursos desde cualquier lugar. Según corresponda, es posible que desees utilizar estos datos de varias maneras:

• Si necesitas gestionar cada elemento de la lista de forma individual, como agregar una etiqueta para cada uno, puedes usar la acción Para cada.
• Si necesitas sumar los datos, como contar cuántos resultados se mostraron, puedes usar las acciones Recuento o Suma.
• Si necesitas exportar la lista, como enviar un correo electrónico con todos los elementos, puedes usar los datos obtenidos directamente en acciones posteriores. Para acceder a los datos devueltos en los pasos que siguen a esta acción, utiliza la variable denominada Obtener datos de sucursal, que es una lista de sucursales. Puedes usar esta variable tanto en condiciones como en acciones. Por ejemplo, puedes enviar la lista de sucursales con la acción Enviar correo electrónico interno del siguiente modo:

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

Nota

Si la acción Obtener datos se usa varias veces en un solo flujo de trabajo, se agrega un número al nombre de la variable. Por ejemplo, en un flujo de trabajo que usa la acción Obtener datos de pedidos dos veces, la primera variable de los datos obtenidos es getOrderData y la segunda, getOrderData1. Este nombre no se puede personalizar.

Activadores

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

Referencia de la API

Para obtener más información sobre la API utilizada en esta acción, consulta la Consulta de sucursales.