Obtener datos de sucursales de la empresa

En los flujos de trabajo que usan datos de sucursales de la empresa, puedes usar la acción Obtener datos de sucursales de la empresa para recuperar información sobre las sucursales de la empresa de la tienda.

Configuración

Campos

La acción Obtener datos de sucursales de la empresa incluye los siguientes campos, que se usan para construir la consulta:

Cadena de consulta

Este es un ejemplo de consulta para obtener las sucursales de la empresa que se actualizaron en el último día:

updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'

La variable updated_at es un filtro disponible en la consulta de sucursales de la empresa y puede usarse varias veces o combinarse con otras variables. La variable de Liquid scheduledAt está disponible en los flujos de trabajo que usan el activador de hora programada. La etiqueta de Liquid date_minus es una etiqueta especial de Flow que permite restar tiempo a una fecha.

Cuando consultas datos, es útil saber lo siguiente:

• Lista de filtros disponibles para las sucursales de la empresa
• Las consultas deben seguir una sintaxis determinada
• Los valores de los campos de la consulta no siempre están documentados. En algunos casos, los valores se pueden encontrar consultando la documentación de la API. También puedes encontrarlos con frecuencia en las URL del panel de control cuando aplicas filtros. Por ejemplo, para encontrar 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 la Shopify GraphiQL app.
• Ten en cuenta qué pasa si la consulta falla. A menudo, 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 utilizar estos datos de varias maneras:

• Si necesitas procesar cada elemento de la lista individualmente, por ejemplo para agregar una etiqueta a cada uno, usa la acción Para cada.
• Si necesitas realizar agregaciones de datos, como contar cuántos resultados se devolvieron, usa las acciones Contar o Sumar.
• 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 de la empresa, que es una lista de sucursales de la empresa. 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 como esta:

{% for single_company in GetCompanyLocationData %}
* {{ single_company.name }}
{% endfor %}

Activadores

Puedes usar esta acción en cualquier flujo de trabajo, incluido el activador de hora programada. En un flujo de trabajo que usa el activador de hora programada, el flujo comienza a la hora que especificaste, en lugar de hacerlo como resultado de un evento. Como no hay un evento específico en la tienda ni en una aplicación que inicie el flujo, no se incluyen datos automáticamente.

Referencia de la API

• Recurso de sucursales de la empresa
• Filtros de consulta de sucursales de la empresa