Déclencheur du métachamp « Localisation de l'entreprise »
Déclenchez un workflow Shopify Flow dès qu'un métachamp d'emplacement d'entreprise B2B est modifié et récupérez l'ancienne et la nouvelle valeur.
Un client B2B dispose de plusieurs succursales, et chacune d'entre elles accepte les livraisons à des horaires différents. Ces horaires sont enregistrés dans le métachamp Fenêtre de livraison (custom.delivery_window) associé à l'emplacement de l'entreprise, et le service logistique doit être informé de tout changement avant la planification de la prochaine expédition.
Cette page explique comment déclencher un workflow Shopify Flow dès qu’un métachamp d’un emplacement d’entreprise est modifié, à l’aide des extensions Workflow Trigger Extensions. Les étapes sont identiques pour tous les métachamps de ce type de ressource ; l’exemple utilise le champ Fenêtre de livraison (custom.delivery_window).
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 > Emplacements de l'entreprise. Un métachamp sans définition ne peut pas faire l'objet d'un suivi.
- L'autorisation Accès aux données relatives aux entreprises et à leur emplacement (B2B). Veuillez l'accorder sur la page Autorisations de l'application ; pour plus d'informations, consultez Autorisations et accès aux données.
- Les emplacements des entreprises font partie de la fonctionnalité B2B sur Shopify. Ce type de ressource n'est utile que sur une boutique qui gère des entreprises.
1. Suivre le métachamp
- Ouvrez la section Déclencheurs de métachamps dans l'application, puis cliquez sur Ajouter un déclencheur.
- Veuillez sélectionner le type de ressource Emplacement de l'entreprise.
- Cochez le métachamp Délai de livraison. 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 nouveau déclencheur affiche Initialisation pendant que l'application lit la valeur actuelle du métachamp correspondant aux emplacements de votre entreprise existants, puis Actif. C'est grâce à cette première lecture que la toute première modification s'accompagne d'emblée de la bonne valeur antérieure.
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 Metafield Update dans Shopify Flow avec les valeurs suivantes :
| Variable | Valeur |
|---|---|
resourceType |
COMPANYLOCATION |
resourceId |
L'identifiant de l'emplacement de l'entreprise, par exemple gid://shopify/CompanyLocation/1234567890 |
metafieldKey |
Espace de noms et clé, ici custom.delivery_window |
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 àCOMPANYLOCATION. 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 emplacements de l'entreprise. Si vous suivez plusieurs métachamps de ce type, ajoutez comme deuxième critère :metafieldKeyest égal àcustom.delivery_window. - 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
- Envoyez la nouvelle fenêtre à votre opérateur ou à votre outil de planification à l'aide de la fonction Envoyer une requête HTTP.
- Ajoutez une condition sur
metafieldKeylorsque vous effectuez le suivi de plusieurs métachamps relatifs à l'emplacement de l'entreprise. - Conservez l'ancienne valeur dans l'e-mail à l'aide de
metafield.previousValue, afin que personne n'ait à la rechercher.
À quelle vitesse réagit-il ?
Shopify informe l'application lorsqu'un emplacement de l'entreprise est enregistré. Pour une modification qui ne concerne qu'un métachamp, il arrive parfois qu'aucune notification ne soit envoyée ; c'est pourquoi l'application vérifie également vos emplacements d'entreprise environ une fois par minute. Le Workflow devrait s'effectuer en quelques secondes, au plus tard au bout d'une minute ou deux.
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.
