Déclencheur de métachamp « Transfert de stock »
Déclenchez un workflow Shopify Flow quand un métachamp de transfert de stock change, avec l'ancienne et la nouvelle valeur, via Workflow Trigger Extensions.
Un marchand transfère des stocks d'un entrepôt à un autre et saisit la référence de suivi du transporteur dans le métachamp de transfert Référence du transporteur (custom.carrier_reference). Dès que ce métachamp est renseigné, l'entrepôt destinataire devrait en être informé.
Cette page explique comment déclencher un workflow Shopify Flow dès qu’un métachamp d’un transfert de stock est modifié, à l’aide des Workflow Trigger Extensions. Les étapes sont identiques pour tous les métachamps de ce type de ressource ; l’exemple utilise la référence du transporteur (custom.carrier_reference).
Ce dont vous avez besoin
- Une définition de métachamp. Créez-la dans votre espace d'administration Shopify, sous Paramètres > Métachamps et métaobjets > Transferts. Un métachamp sans définition ne peut pas faire l'objet d'un suivi.
- L'autorisation Accès aux données de transferts de stock. Veuillez l'accorder sur la page Autorisations de l'application ; pour plus d'informations, consultez Autorisations et accès aux données.
1. Suivre le métachamp
- Ouvrez la section Déclencheurs de métachamps dans l'application, puis cliquez sur Ajouter un déclencheur.
- Sélectionnez le type de ressource Transfert.
- Cochez le métachamp « Référence de l'opérateur ». Vous pouvez en cocher plusieurs à la fois ou utiliser l'option Tout sélectionner.
- Cliquez sur Ajouter un déclencheur.
Pour suivre tous les métachamps de ce type de ressource, y compris ceux que vous créerez ultérieurement, sélectionnez Tous les métachamps au lieu de cocher chacun d'entre eux individuellement, puis cliquez sur Suivre tous les métachamps.

Le déclencheur est immédiatement actif. La première fois que l'application lit un transfert de stock, elle enregistre la valeur actuelle sans lancer un workflow ; toute modification ultérieure en déclenche un.
Si le métachamp ne figure pas dans la liste, cliquez sur Actualiser les métachamps sur la page « Déclencheurs de métachamps » : l'application conserve la liste des définitions pendant une heure.
2. Ce que reçoit le workflow
Chaque modification déclenche l'événement Métachamp Update dans Shopify Flow avec les valeurs suivantes :
| Variable | Valeur |
|---|---|
resourceType |
TRANSFER |
resourceId |
L'identifiant du transfert de stock, par exemple gid://shopify/InventoryTransfer/1234567890 |
metafieldKey |
Espace de noms et clé, ici custom.carrier_reference |
metafield.value |
La nouvelle valeur |
metafield.previousValue |
La valeur avant la modification ; vide lorsque le métachamp a été défini pour la première fois |
metafield.type |
Le type du métachamp, par exemple single_line_text_field |
3. Mettre en place le workflow
- Dans Shopify Flow, créez un workflow et sélectionnez le déclencheur Mise à jour du métachamp parmi les extensions de déclencheurs de Workflow Trigger Extensions.
- Ajoutez une condition :
resourceTypeest égal àTRANSFER. La mise à jour des métachamps est déclenchée pour chaque type de ressource que vous suivez ; cette condition permet donc de limiter ce workflow aux transferts de stock. Si vous suivez plusieurs métachamps de ce type, ajoutez comme deuxième critère :metafieldKeyest égal àcustom.carrier_reference. - Ajoutez l'action souhaitée. Dans cet exemple, un e-mail interne est envoyé, indiquant l'ancienne et la nouvelle valeur.

Commencez par l'exemple
- Téléchargez le fichier
.flowjoint au bas de cette page. - Dans votre interface d'administration Shopify, ouvrez Shopify Flow, cliquez sur Importer et sélectionnez le fichier.
- Ouvrez l'étape Envoyer un e-mail interne et saisissez le destinataire. Le fichier ne contient délibérément aucune adresse.
- Activez le workflow.
Faites-en le vôtre
- Ajoutez la condition «
metafield.previousValueest vide » afin que la réaction ne se produise que lorsque la référence est renseignée pour la première fois. - Envoyez la référence au système de l'entrepôt destinataire à l'aide de la fonction Envoyer une requête HTTP.
- Ajoutez une condition sur
metafieldKeylorsque vous suivez plusieurs métachamps de transfert.
À quelle vitesse réagit-il ?
Shopify n'envoie aucune notification à ce sujet ; l'application lit donc les métachamps suivis environ une fois par minute. Le workflow devrait s'exécuter d'ici une minute ou deux.
Bon à savoir
- Les transferts créés au cours des 90 derniers jours font l'objet d'un suivi. La modification d'un métachamp sur un transfert plus ancien ne déclenche aucun workflow.
- Un nouveau transfert est détecté pour la première fois au bout d'environ une minute. La valeur que le métachamp possède déjà à ce moment-là constitue sa valeur initiale et ne déclenche aucun workflow ; en revanche, toute modification ultérieure en déclenche un.
En savoir plus
- Déclencheurs de métachamps : fonctionnement des déclencheurs de métachamps, pour chaque type de ressource.
- Historique des événements et dépannage : consultez tous les événements envoyés par l'application, avec l'ancienne et la nouvelle valeur.
