Récupérer les données de commande
Dans les flux de travail qui nécessitent des données de commande, vous pouvez utiliser l’action Récupérer les données de commande pour récupérer les informations sur les commandes de votre boutique.
Configuration
Champs
L’action Récupérer les données de commande contient les champs suivants, qui sont utilisés pour créer la requête :
| Champ | Description |
|---|---|
| Trier les données par | Obligatoire. Les paramètres selon lesquels les données renvoyées par la requête de recherche sont triées. |
| Nombre maximal de résultats | Obligatoire. Le nombre maximal 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 | Obligatoire. 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 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 sur la requête de commandes et peut être utilisée plusieurs fois ou combinée avec d’autres variables. La variable Liquid scheduledAt est disponible pour les flux de travail qui utilisent le déclencheur Heure programmée. La balise Liquid date_minus est une balise Flow spéciale qui vous permet de soustraire une durée à une date.
Lorsque vous interrogez des données, il est utile de savoir ce qui suit :
- Liste des filtres de commande 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, 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 à l’aide de l’application Shopify GraphiQL.
- Faites attention à ce qui se passe si votre requête échoue. Souvent, l’API renverra 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. En fonction de votre cas d’utilisation, vous pouvez utiliser ces données de plusieurs manières :
- 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 devez 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 d’utiliser la liste complète, 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 order data, qui est une liste de commandes. Vous pouvez utiliser cette variable dans les conditions et les actions. Par exemple, vous pouvez envoyer la liste de commandes dans une action Envoyer un e-mail interne comme suit :
{% 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 avec le déclencheur Heure programmée. Dans un flux de travail qui utilise le déclencheur Heure programmée, le flux de travail démarre à une heure que vous avez spécifiée, plutôt qu’à la suite d’un événement. Puisqu’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
Annuler les commandes des clients effectuant des retours fréquents
Annule les commandes des clients qui ont retourné des articles au moins cinq fois au cours des six derniers mois. Il récupère les données de commande, compte les retours et annule la commande en cours, en émettant un remboursement et en remettant les articles en stock. Ce modèle peut être utilisé pour : réduire les pertes dues aux clients qui effectuent des retours de manière habituelle, 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 si le client a passé plus de 5 commandes aujourd’hui
Annule les commandes si un client passe plus de cinq commandes en une seule journée. Il vérifie le nombre de commandes passées par un client au cours des dernières 24 heures et annule toutes les commandes dépassant cette limite, en balisant le client pour une fraude potentielle. Afficher le modèle
Suspendre les ordres de traitement de la commande pour les clients ayant des rétrofacturations
Lorsqu’une commande est prête à être traitée, le flux de travail récupère toutes les commandes du même client datant des 60 derniers jours qui ont fait l’objet d’une rétrofacturation. S’il existe de telles commandes, il suspend le traitement de chaque envoi et envoie un e-mail interne pour en informer vos opérations. Afficher le modèle
Suspendre les traitements des commandes si un client a passé plusieurs commandes en 24 heures
Vérifie si un client a passé plusieurs commandes sur une période de 24 heures. Si c’est le cas, suspend le traitement des commandes et regroupe l’expédition. Afficher le modèle
Suspendre les commandes si le client a passé plus d’une commande au cours des dernières 24 heures
Lorsqu’une commande est créée, vérifie si le client a passé d’autres commandes au cours des dernières 24 heures. Si c’est le cas, suspend toutes les commandes. Afficher le modèle
Envoyer une notification lorsque le volume de commandes est inférieur à 10 au cours de la dernière heure
Envoie une notification de contrôle des commandes. Toutes les heures, récupère jusqu’à 10 commandes créées et les compte. Si le nombre est inférieur à 10, une notification est envoyée par e-mail. Utilise les étapes Programmer l’heure, Obtenir les données sur les commandes et Compter. Afficher le modèle
Envoyer un résumé par e-mail de toutes les commandes de la boutique en ligne du jour précédent
Chaque jour, récupère les commandes du jour précédent et envoie un résumé par e-mail de celles qui ont été passées sur la boutique en ligne. Afficher le modèle
Envoyer un résumé par e-mail de toutes les commandes non traitées datant de plus de 2 jours
Permet d’obtenir un résumé quotidien de toutes les commandes non traitées datant de plus de 2 jours, en utilisant les étapes Programmer, Obtenir les données sur les commandes, Compter et Somme. Afficher le modèle
Baliser et envoyer un résumé quotidien des traitements de commandes en retard
Chaque jour, balise et envoie un résumé quotidien par e-mail qui comptabilise le nombre total et la valeur monétaire de toutes les commandes qui ne respectent pas une garantie d’expédition de 2 jours. Afficher le modèle
Baliser les clients qui ont une rétrofacturation
Toutes les heures, ce flux de travail récupère les commandes avec des rétrofacturations et ajoute une balise au client de la commande. Il utilise le déclencheur Heure programmée, l’action Obtenir les données sur les commandes et la boucle for each. 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 de plus de 2 jours et leur ajoute une balise. 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, ce flux de travail récupère le total et le nombre de commandes du client des 6 derniers mois, puis ajoute des balises au client. Il utilise les actions Obtenir les données sur les commandes, Compter et Somme. Afficher le modèle