Obtenir les données de session de suivi des fonds

Dans les flux de travail qui nécessitent des données sur les sessions de suivi des fonds, vous pouvez utiliser l’action Obtenir les données de session de suivi des fonds pour récupérer ces informations depuis votre POS Pro. Les sessions de suivi des fonds servent à suivre les espèces dans les caisses de votre boutique.

Configuration

Champs

L’action Obtenir les données de session de suivi des fonds contient les champs suivants.

Chaîne de requête

Voici un exemple de requête pour obtenir les sessions de suivi des fonds qui ont été fermées au cours de la dernière journée :

closing_time:<='{{ scheduledAt }}' AND closing_time:>'{{ scheduledAt | date_minus: "1 day" }}'

La variable closing_time est un filtre disponible dans la requête CashTrackingSessions et peut être utilisée plusieurs fois ou combinée avec d’autres variables. La variable Liquid scheduledAt est disponible dans 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 du temps à une date.

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

• Liste des filtres de session de suivi des fonds 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. Vous pouvez aussi souvent trouver les valeurs de champ dans les URL de l’interface administrateur lorsque vous appliquez des filtres. Par exemple, pour trouver des valeurs de requête de commande, filtrez la page Commandes dans votre interface administrateur, puis vérifiez l’URL.

• Vous pouvez exécuter ou tester une requête dans votre boutique en utilisant l’application Shopify GraphiQL.

• Faites attention à ce qui se passe si votre requête échoue. L’API renverra souvent tous les résultats (au lieu de n’en renvoyer 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 pouvez 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, 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 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 Get cash tracking session data, qui est une liste de sessions de suivi des fonds. Vous pouvez utiliser cette variable dans les conditions et les actions. Par exemple, vous pouvez envoyer la liste des sessions de suivi des fonds dans une action Envoyer un e-mail interne comme ceci :

{% for single_cash_tracking_session in GetCashTrackingSessionData %}
* {{ single_cash_tracking_session.id }}
{% 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. Étant donné qu’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 incluse automatiquement.

Référence d’API

Pour en savoir plus sur l’API utilisée dans cette action, consultez la requête CashTrackingSessions.