Obtener datos del catálogo

En flujos de trabajo que requieren datos del catálogo, puedes usar la acción Obtener datos del catálogo para recuperar información del catálogo B2B de la tienda. Los catálogos son grupos de productos con precios personalizados para clientes B2B o sucursales de la empresa específicos.

Nota

Este es un tipo de acción Obtener datos. Para entender cómo usar este tipo de acción con el activador Hora programada y bucles For each, consulta Programaciones, obtención de datos y creación de bucles para flujos de trabajo en Shopify Flow.

Configuración

Campos

La acción Obtener datos del catálogo 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 arrojados por 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 devolver hasta 100 a la vez.
Consulta	Obligatorio. Elige entre las consultas comunes o selecciona Avanzado para crear la tuya.

Cadena de consulta

Este es un ejemplo de consulta para obtener todos los catálogos activos:

status:ACTIVE

La variable status es un filtro disponible en la consulta de catálogos que se puede usar varias veces o combinarse con otras variables.

Cuando consultes datos, es útil saber lo siguiente:

• Lista de filtros de catálogo disponibles

• Las consultas deben seguir una sintaxis determinada

• Los valores del campo de consulta no siempre están documentados. En algunos casos, se pueden encontrar revisando la documentación de la API. Por otro lado, a menudo puedes encontrar los valores de los campos en las URL del panel de control cuando aplicas filtros. Por ejemplo, para buscar 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 tu tienda con la aplicación Shopify GraphiQL.

• Ten en cuenta lo que sucede 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. Dependiendo de tu caso de uso, tal vez quieras usar estos datos de varias maneras:

• Si necesitas procesar cada artículo de la lista por separado, como para agregar una etiqueta a cada uno, puedes usar la acción Para cada uno.
• Si necesitas agregar datos, como por ejemplo contar cuántos resultados se devolvieron, puedes usar las acciones Recuento o Suma.
• Si necesitas exportar la lista, por ejemplo para enviar un correo electrónico con todos los artículos, puedes usar los datos devueltos directamente en acciones posteriores.

Para acceder a los datos devueltos en los pasos posteriores a esta acción, usa la variable llamada Obtener datos del catálogo, que es una lista de catálogos. Puedes usar esta variable tanto en las condiciones como en las acciones. Por ejemplo, puedes enviar la lista de catálogos en una acción de Enviar correo electrónico interno de manera similar a esta:

{% for single_catalog in getCatalogData %}
  * {{ single_catalog.title }}
{% endfor %}

Nota

Si una acción de Obtener datos se usa varias veces en un mismo 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 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, lo que incluye el activador de Hora programada. En un flujo de trabajo que usa este activador, el flujo de trabajo comienza en la hora que especificaste, en lugar de hacerlo a causa de un evento. Debido a que no hay ningún evento específico en tu tienda o de una aplicación que inicie el flujo de trabajo, no se incluyen datos automáticamente.

Referencia de la API

Para obtener más información sobre la API que se usa en esta acción, consulta la consulta de catálogos.