Obtenir les données d’article en stock

Dans les flux de travail nécessitant des données d’articles en stock, vous pouvez utiliser l’action Obtenir les données d’article en stock pour récupérer les informations sur les articles en stock dans votre boutique. Les articles en stock représentent les unités de stock réelles qui sont suivies pour les variantes de produit.

Sur cette page

Configuration

Champs

L’action Obtenir les données d’article en stock contient les champs suivants :

Champs utilisés dans les actions Obtenir des données.
Champ	Description
Trier les données par	Requis. Les paramètres par lesquels les données renvoyées par la requête de recherche sont triées.
Nombre maximum de résultats	Requis. Le nombre maximum de résultats pouvant être renvoyés par la requête de recherche que vous sélectionnez. Vous pouvez en renvoyer jusqu’à 100 à la fois.
Requête	Requis. Choisissez parmi les requêtes courantes ou sélectionnez Avancé pour créer la vôtre.

Chaîne de requête

Voici un exemple de requête pour obtenir les articles en stock qui sont suivis :

tracked:true

La variable tracked est un filtre disponible pour la requête d’articles en stock. Elle peut être utilisée plusieurs fois ou combinée avec d’autres variables.

Lors de l’interrogation des données, il est utile de savoir ce qui suit :

Liste des filtres d’articles en stock disponibles
Les requêtes doivent respecter une certaine syntaxe
Les valeurs des champs de requête ne sont pas toujours documentées. Dans certains cas, il est possible de les trouver en consultant la documentation de l’API. Vous pouvez également souvent trouver les valeurs de champ dans les URL de l’interface administrateur lorsque vous appliquez un filtre. Par exemple, pour trouver certaines valeurs de requête de commande, filtrez la page Commandes dans l’interface administrateur, puis vérifiez l’URL.
Vous pouvez exécuter ou tester une requête dans votre boutique à l’aide de l’application Shopify GraphiQL.
Gardez à l’esprit que si votre requête échoue, l’API renvoie souvent tous les résultats (au lieu d’aucun).

Données renvoyées

Toutes les actions Obtenir des données renvoient une liste de 0 à 100 ressources. Selon votre cas d’utilisation, vous souhaiterez peut-être utiliser ces données de différentes manières :

Si vous devez traiter chaque élément de la liste individuellement, par exemple pour ajouter une balise à chacun d’eux, vous pouvez utiliser l’action Pour chaque.
Si vous avez besoin d’agréger des données, par exemple pour compter le nombre de résultats renvoyés, vous pouvez utiliser les actions Compter ou Somme.
Si vous avez besoin de générer la liste, par exemple pour envoyer un e-mail contenant tous les articles, vous pouvez utiliser les données renvoyées directement dans les actions suivantes.

Pour accéder aux données renvoyées dans les étapes qui suivent cette action, utilisez la variable nommée Obtenir les données de l’article en stock, qui est une liste d’articles en stock. Vous pouvez utiliser cette variable dans des conditions et des actions. Par exemple, vous pouvez envoyer la liste d’articles en stock dans une action Envoyer un e-mail interne semblable à celle-ci :

{% for single_inventory_item in getInventoryItemData %}
  * SKU: {{ single_inventory_item.sku }} - Cost: {{ single_inventory_item.unitCost.amount }}
{% endfor %}

Déclencheurs

Vous pouvez utiliser cette action dans n’importe quel flux de travail, y compris le déclencheur Heure prévue. Dans un flux de travail qui l’utilise, le flux de travail commence à l’heure que vous avez spécifiée, plutôt qu’à la suite d’un événement. Étant donné qu’aucun événement spécifique dans votre boutique ou provenant d’une application ne lance le flux de travail, aucune donnée n’est incluse automatiquement.

Référence de l’API

Pour plus d’informations sur l’API utilisée dans cette action, consultez la requête d’articles en stock.