Obtenir les données des commandes
Dans les flux de travail requérant les données des commandes, vous pouvez vous servir de l’action Obtenir les données des commandes pour récupérer les données des commandes dans votre boutique.
Sur cette page
Configuration
Champs
L’action Obtenir les données des commandes contient les champs suivants, qui sont utilisés pour créer la requête :
| Champ | Description |
|---|---|
| Trier les données par | Obligatoire. Paramètres selon lesquels les données renvoyées par la requête de recherche sont triées. |
| Nombre maximum de résultats | Obligatoire. 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ête | Obligatoire. 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 qui ont été mises à jour au cours du dernier jour :
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'La variable updated_at est un filtre disponible dans la requête des commandes et peut être utilisée plusieurs fois ou combinée à d’autres variables. La variable Liquid scheduledAt est disponible dans les flux de travail qui utilisent le déclencheur Date/heure prévues. La balise Liquid date_minus est une balise Flow spéciale, qui vous permet de soustraire du temps d’une date.
Lorsque vous requerrez des données, il est utile de connaître ce qui suit :
- Liste des filtres de commande 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 collections, qui est une liste de collections. Vous pouvez utiliser cette variable à la fois dans les conditions et les actions. Par exemple, vous pouvez envoyer la liste des collections dans une action Envoyer un e-mail interne comme celle-ci :
{% for single_order in GetOrderData %}
- {{ single_order.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.
Détails de l’API
Modèles
Annuler les commandes pour les clients qui retournent souvent
Annule les commandes des clients qui ont retourné des articles cinq fois ou plus au cours des six derniers mois. Il récupère les données de la commande, compte les retours et annule la commande en cours, en procédant à un remboursement et à la remise en stock d’articles. Ce modèle peut être utilisé pour : réduire les pertes dues aux retours habituels, rationaliser la gestion des commandes en traitant de manière préventive les retours potentiels, et maintenir la rentabilité en décourageant les retours excessifs. Afficher le modèle
Annuler les commandes d’un(e) client(e) ayant passé plus de 5 commandes dans la journée
Annule les commandes si un(e) client(e) passe plus de cinq commandes au cours d’une même journée. Il vérifie le nombre de commandes passées par un(e) client(e) au cours des dernières 24 heures et annule toute commande dépassant cette limite, en balisant le/la client(e) en cas de fraude potentielle. Afficher le modèle
Suspendre le traitement des commandes pour les clients ayant fait l’objet d’une rétrofacturation
Lorsqu’une commande est prête à être traitée, le flux de travail récupère toutes les commandes passées par le/la même client(e) au cours des 60 derniers jours et qui ont fait l’objet d’une rétrofacturation. Si de telles commandes existent, le traitement de chaque envoi est suspendu et un e‑mail interne est envoyé pour notifier vos opérations. Afficher le modèle
Suspendre les traitements des commandes si un(e) client(e) a passé plusieurs commandes en 24 heures
Vérifiez si un(e) client(e) a passé plusieurs commandes au cours d’une période de 24 heures. Si c’est le cas, suspendez les traitements des commandes et regroupez les envois. Afficher le modèle
Suspendre les commandes lorsqu’un(e) client(e) a passé plusieurs commande au cours des 24 dernières heures
Lorsqu’une commande est créée, vérifiez si le/la client(e) a passé d’autres commandes au cours des 24 dernières heures. Si c’est le cas, suspendez toutes les commandes. Afficher le modèle
Envoyer une notification lorsque le volume de commande est inférieur à 10 dans la dernière heure
Envoie une notification de commande périodique. Chaque heure, récupérez jusqu’à 10 commandes créées et comptez‑les. Si les commandes sont moins de 10, envoyez une notification par e‑mail. Utilise les étapes Date/heure prévues, Obtenir les données des commandes et Quantité. Afficher le modèle
Envoyer un résumé par e‑mail de toutes les commandes passées auprès de la boutique en ligne lors de la journée écoulée
Chaque jour, cette fonction récupère les commandes passées pendant la journée écoulée et envoie un résumé par e‑mail avec les commandes passées auprès de la boutique en ligne. Afficher le modèle
Envoyer un résumé par e‑mail avec toutes les commandes non traitées datant de plus de 2 jours
Obtenez un résumé quotidien de toutes vos commandes non traitées de plus de 2 jours, en utilisant les calendriers ; obtenez les données, le nombre et la somme des commandes. Afficher le modèle
Baliser et envoyer un résumé quotidien des traitements en retard
Chaque jour, balisez et envoyez un e‑mail de résumé quotidien qui comptabilise le nombre total et la valeur marchande de toutes les commandes pour lesquelles la garantie d’expédition en deux jours n’a pas été respectée. Afficher le modèle
Baliser les clients qui ont bénéficié d’une rétrofacturation
Toutes les heures, ce flux de travail récupère les commandes ayant fait l’objet d’une rétrofacturation et ajoute une balise au/à la client(e) pour la commande. Utilise le déclencheur Date/heure prévues, Obtenir les données des commandes et la boucle Pour chaque. Afficher le modèle
Baliser les commandes non traitées datant de plus de 2 jours
Chaque jour, le flux de travail récupère toutes les commandes non traitées datant de plus de 2 jours et ajoute une balise à la commande. Afficher le modèle
Utiliser des balises pour segmenter les clients en fonction de leurs commandes des 6 derniers mois
Lorsqu’une nouvelle commande est créée, obtenez le total et le nombre de commandes du/de la client(e) pour les 6 derniers mois, puis ajoutez des balises au/à la client(e). Utilise Obtenir les données des commandes, Quantité, Somme. Afficher le modèle