Obtener datos del artículo de inventario
En los flujos de trabajo que requieran datos de artículos de inventario, puedes usar la acción Obtener datos del artículo de inventario para recuperar información del artículo de inventario de tu tienda. Los artículos de inventario representan las unidades de existencias reales para las que se realiza el seguimiento en las variantes de producto.
Configuración
Campos
La acción Obtener datos del artículo de inventario contiene los siguientes campos:
| Campo | Descripción |
|---|---|
| Ordenar datos por | Obligatorio. Los parámetros que se usan para ordenar 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 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 artículos de inventario a los que se les realiza seguimiento:
tracked:trueLa variable tracked es un filtro disponible en la consulta de artículos de inventario que se puede usar varias veces o combinarse con otras variables.
Cuando consultes datos, es útil saber lo siguiente:
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 generar la lista, como para enviar un correo electrónico con todos los artículos, puedes usar los datos devueltos directamente en las acciones posteriores.
Para acceder a los datos devueltos en los pasos que siguen a esta acción, usa la variable llamada Obtener datos de artículo de inventario, que es una lista de artículos de inventario. Puedes usar esta variable tanto en las condiciones como en las acciones. Por ejemplo, puedes enviar la lista de artículos de inventario en una acción Enviar correo electrónico interno similar a esta:
{% for single_inventory_item in getInventoryItemData %}
* SKU: {{ single_inventory_item.sku }} - Cost: {{ single_inventory_item.unitCost.amount }}
{% endfor %}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 de trabajo comienza en la hora que hayas especificado en lugar de como resultado de un evento. Dado que no hay ningún evento específico en la tienda o desde 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 artículos de inventario.