Obtenir les données des commandes à traiter

Vous pouvez utiliser l’action Obtenir les données des commandes à traiter pour récupérer les informations relatives aux commandes à traiter sur votre boutique.

Configuration

Champs

L’action Obtenir les données des commandes à traiter contient les champs suivants, qui sont utilisés pour créer la requête :

Champs utilisés dans les actions « Obtenir des données ».
ChampDescription
Trier les données parObligatoire. Paramètres selon lesquels les données renvoyées par la requête de recherche sont triées.
Nombre maximum de résultatsObligatoire. La quantité maximale de résultats qui peut être renvoyée par la requête de recherche que vous sélectionnez. Vous pouvez en retourner jusqu’à 100 à la fois.
RequêteObligatoire. Choisissez parmi les requêtes courantes ou sélectionnez Avancée pour créer les vôtres.

Chaîne de requête

Il s’agit d’un exemple de requête pour obtenir des commandes à traiter actuellement en attente :

status:ON_HOLD

La variable status est un filtre disponible dans la requête des commandes à traiter et peut être utilisée plusieurs fois ou combinée à d’autres variables.

Lorsque vous requerrez des données, il est utile de connaître ce qui suit :

  • Liste des filtres de commande à traiter disponibles - Les requêtes doivent suivre une certaine syntaxe
  • Les noms de champs pour toutes les requêtes se trouvent dans les documents des développeurs pour l’objet QueryRoot.
  • Les valeurs des champs de requête ne sont pas toujours documentées. Dans certains cas, les valeurs peuvent être trouvées en regardant les documents de l’API. Vous pouvez aussi souvent trouver les valeurs de champ dans les URL de l’interface administrateur lorsque vous filtrez. Par exemple, pour trouver des 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 GraphiQL de Shopify.
  • Sachez ce qui se produira si votre requête échoue. Souvent, l’API retournera tous les résultats (au lieu d’aucun).

Données renvoyées

Toutes les actions Obtenir des données renvoient une liste entre 0 et 100 ressource. Selon l’usage que vous en faites, vous voudrez peut-être utiliser ces données de différentes manières :

  • Si vous devez gérer chaque article de la liste individuellement, par exemple pour ajouter une balise à chacun, vous pouvez utiliser l’action Pour chacun.
  • Si vous devez agréger les données, telles que le nombre de résultats retournés, vous pouvez utiliser les actions Quantité ou Somme.
  • Si vous avez besoin d’une liste de sorties, comme envoyer un e-mail avec tous les articles, vous pouvez utiliser les données renvoyées directement dans les actions suivantes.

Pour accéder aux données renvoyées selon les étapes qui suivent cette action, utilisez la variable appelée Obtenir les données des commandes à traiter, qui est une liste de commandes à traiter. Vous pouvez utiliser cette variable à la fois dans les conditions et les actions. Par exemple, vous pouvez envoyer la liste des commandes à traiter dans une action Envoyer un e-mail interne comme celle-ci :

{% for fulfillment_order in GetFulfillmentOrderData %}
- Order: {{ fulfillment_order.order.name }} Location: {{ fulfillment_order.assignedLocation.name }}
{% endfor %}

Déclencheurs

Vous pouvez utiliser cette action dans n’importe quel flux de travail, y compris dans le déclencheur Date/heure prévues. Dans un flux de travail utilisant le déclencheur Date/heure prévues, le flux démarre à un moment que vous avez spécifié, plutôt qu’à la suite d’un événement. Étant donné qu’il n’y a pas d’événement spécifique dans votre boutique ou provenant d’une application qui démarre le flux de travail, aucune donnée n’est incluse automatiquement.

Exemple

Exemple d’un flux de travail qui se répète une fois par jour, vérifie les commandes à traiter qui sont suspendues et envoie un résumé par e-mail

Dans cet exemple de flux de travail, un flux de travail est programmé pour être exécuté chaque jour à 16 h 34. L’action Obtenir les données des commandes à traiter est utilisée pour collecter les données des commandes suspendues. Une liste des commandes suspendues est envoyée par e-mail aux personnes travaillant pour votre boutique.

Référence de l’API

Vous ne trouvez pas les réponses que vous recherchez ? Nous sommes là pour vous aider.