Trigger voor het metaveld ‘Bedrijfslocatie’
Start een Shopify Flow-workflow wanneer een metaveld van een B2B-bedrijfslocatie verandert, met de oude en nieuwe waarde beschikbaar in de workflow.
Een B2B-klant heeft meerdere locaties, en elke locatie neemt leveringen op andere tijdstippen in ontvangst. De tijdstippen worden bijgehouden in het metaveld Leveringsvenster (custom.delivery_window) van de bedrijfslocatie, en de logistieke afdeling moet op de hoogte worden gesteld van een wijziging voordat de volgende zending wordt gepland.
Op deze pagina wordt uitgelegd hoe u met behulp van Workflow Trigger Extensions een Shopify Flow-workflow kunt starten wanneer een metaveld van een locatie verandert. De stappen zijn voor elk metaveld van dit resourcetype hetzelfde; in het voorbeeld wordt gebruikgemaakt van Leveringsvenster (custom.delivery_window).
Wat u nodig hebt
- Een metaveld-definitie. U kunt deze aanmaken in uw Shopify-beheeromgeving onder Instellingen > Metavelden en meta-objecten > Bedrijfslocaties. Een metaveld zonder definitie kan niet worden bijgehouden.
- De machtiging Toegang tot bedrijfs- en bedrijfslocatiegegevens (B2B). Verleen deze machtiging op de pagina Machtigingen van de app; zie Toestemmingen en toegang tot gegevens.
- Bedrijfslocaties maken deel uit van B2B op Shopify. Dit type bron is alleen van nut in een winkel waarin bedrijven zijn ondergebracht.
1. Houd het metaveld bij
- Open Metaveld-triggers in de app en klik op Trigger toevoegen.
- Kies het resourcetype Bedrijfslocatie.
- Vink het metaveld aan, in dit geval Leveringsvenster. U kunt meerdere velden tegelijk aanvinken of de optie Alles selecteren gebruiken.
- Klik op Trigger toevoegen.
Om elk metaveld van dit resourcetype bij te houden, inclusief de velden die u later aanmaakt, selecteert u Alle metavelden in plaats van afzonderlijke velden aan te vinken, en klikt u vervolgens op Alle metavelden bijhouden.

De nieuwe trigger geeft Initializing weer terwijl de app de huidige waarde van het metaveld voor uw bestaande bedrijfslocaties uitleest, en vervolgens Active. Die eerste uitlezing is de reden waarom de allereerste wijziging al met de juiste vorige waarde binnenkomt.
Indien het metaveld ontbreekt in de lijst, klikt u op Metavelden vernieuwen op de pagina ‘Metaveldtriggers’: de app onthoudt de lijst met definities gedurende een uur.
2. Wat de workflow ontvangt
Elke wijziging activeert de trigger Metaveld Update in Shopify Flow met de volgende waarden:
| Variabele | Waarde |
|---|---|
resourceType |
COMPANYLOCATION |
resourceId |
Het ID van de bedrijfslocatie, bijvoorbeeld gid://shopify/CompanyLocation/1234567890 |
metafieldKey |
Naamruimte en sleutel, in dit geval custom.delivery_window |
metafield.value |
De nieuwe waarde |
metafield.previousValue |
De waarde vóór de wijziging; leeg wanneer het metaveld voor het eerst werd ingesteld |
metafield.type |
Het type van het metaveld, bijvoorbeeld single_line_text_field |
3. Stel de workflow samen
- Maak in Shopify Flow een workflow aan en kies de trigger Metaveld Update van Workflow Trigger Extensions.
- Voeg een voorwaarde toe:
resourceTypeis gelijk aanCOMPANYLOCATION. De update van het metaveld wordt gestart voor elk resourcetype dat u bijhoudt, zodat deze voorwaarde ervoor zorgt dat deze workflow beperkt blijft tot bedrijfslocaties. Wanneer u meerdere metavelden van dit type bijhoudt, voeg danmetafieldKeyis gelijk aancustom.delivery_windowtoe als tweede criterium. - Voeg de gewenste actie toe. In het voorbeeld wordt een interne e-mail verzonden met de oude en de nieuwe waarde.

Begin met het voorbeeld
- Download het
.flow-bestand dat onderaan deze pagina is bijgevoegd. - Open Shopify Flow in uw Shopify-beheerdersgedeelte, klik op Importeren en selecteer het bestand.
- Open de stap Interne e-mail verzenden en voer de ontvanger in. Het bestand bevat bewust geen adres.
- Schakel de workflow in.
Maak het tot het uwe
- Stuur het nieuwe venster naar uw provider of planningstool met de optie HTTP-verzoek verzenden.
- Voeg een voorwaarde toe voor
metafieldKeywanneer u meerdere metavelden voor bedrijfslocaties bijhoudt. - Vermeld de oude waarde in de e-mail via
metafield.previousValue, zodat niemand deze hoeft op te zoeken.
Hoe snel reageert het?
Shopify stelt de app op de hoogte wanneer een bedrijfslocatie wordt opgeslagen. Bij een wijziging die uitsluitend betrekking heeft op een metaveld, wordt soms geen melding verzonden; daarom controleert de app uw bedrijfslocaties ook ongeveer één keer per minuut. U kunt de workflow binnen enkele seconden verwachten, en uiterlijk na een minuut of twee.
Meer
- Metaveld-triggers : hoe metafield-triggers werken, voor elk type resource.
- Gebeurtenisgeschiedenis en probleemoplossing : bekijk alle gebeurtenissen die de app heeft verzonden, met zowel de oude als de nieuwe waarde.
