Obtenir les données des ordres de traitement de la commande

Vous pouvez utiliser l’action Obtenir les données des ordres de traitement de la commande pour récupérer des informations d’ordre de traitement de la commande depuis votre boutique.

Configuration

Champs

L’action Obtenir les données des ordres de traitement de la commande 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. Les paramètres par lesquels les données renvoyées par la requête de recherche sont triées.
Nombre maximal de résultatsObligatoire. Le nombre maximal de résultats qui peuvent être renvoyés par la requête de recherche que vous sélectionnez. Vous pouvez en renvoyer jusqu’à 100 à la fois.
RequêteObligatoire. 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 commandes traitées qui sont actuellement suspendues :

status:ON_HOLD

La variable status est un filtre disponible sur la requête Fulfillment Orders et peut être utilisée plusieurs fois ou combinée à d’autres variables.

Lorsque vous interrogez des données, il est utile de savoir ce qui suit :

  • Liste des filtres d’ordres de traitement de commande disponibles
  • Les requêtes doivent suivre une certaine syntaxe
  • Les valeurs des champs de requête ne sont pas toujours documentées. Dans certains cas, vous pouvez les trouver en consultant la documentation de l’API. Sinon, vous pouvez souvent trouver les valeurs des champs 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 en utilisant l’appli Shopify GraphiQL.
  • Faites attention à ce qui se passe en cas d’échec de votre requête. Souvent, l’API renverra tous les résultats (au lieu d’aucun).

Données renvoyées

Toutes les actions Récupérer les données renvoient une liste de 0 à 100 ressources. En fonction de votre cas d’utilisation, vous pouvez utiliser ces données de plusieurs façons :

  • Si vous devez traiter chaque article de la liste individuellement, par exemple pour ajouter une balise à chacun, vous pouvez utiliser l’action Pour chaque.
  • Si vous avez besoin de regrouper des données, par exemple pour compter le nombre de résultats renvoyés, vous pouvez utiliser les actions Compter ou Somme.
  • Si vous devez 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 Get fulfillment order data, qui est une liste de commandes traitées. Vous pouvez utiliser cette variable dans les conditions et les actions. Par exemple, vous pouvez envoyer la liste des commandes traitées 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 avec le déclencheur Heure planifiée. Dans un flux de travail qui utilise le déclencheur Heure planifiée, le flux de travail démarre à une heure que vous avez spécifiée, plutôt qu’à la suite d’un événement. Comme aucun événement spécifique dans votre boutique ou provenant d’une application ne démarre le flux de travail, aucune donnée n’est automatiquement incluse.

Détails de l’API

Modèles

Envoyer un résumé quotidien par e-mail avec la liste des commandes traitées qui sont suspendues

Chaque jour, ce flux de travail interroge toutes les commandes traitées qui sont suspendues (jusqu’à 100 à la fois). Il envoie un résumé par e-mail contenant le nom de la commande et l’emplacement de traitement des commandes attribué. Afficher le modèle