Trigger voor het metaveld ‘Voorraadoverdracht’

Trigger voor het metaveld ‘Voorraadoverdracht’

Pagina kopiëren

Start een Shopify Flow-workflow wanneer een metaveld voor voorraad verandert. Volg dit in Workflow Trigger Extensions en bekijk de oude en de nieuwe waarde.

Een handelaar verplaatst voorraad tussen magazijnen en vult de trackingreferentie van de vervoerder in het metaveld Vervoerderreferentie (custom.carrier_reference) in. Zodra dit metaveld is ingevuld, dient het ontvangende magazijn deze informatie te ontvangen.

Op deze pagina wordt uitgelegd hoe u met behulp van Workflow Trigger Extensions een Shopify Flow-workflow kunt starten telkens wanneer een metaveld van een voorraadoverdracht verandert. De stappen zijn voor elk metaveld van dit resourcetype hetzelfde; in het voorbeeld wordt gebruikgemaakt van Carrier reference (custom.carrier_reference).

Wat u nodig hebt

  • Een metaveld-definitie. U kunt deze aanmaken in uw Shopify-beheeromgeving onder Instellingen > Metavelden en meta-objecten > Overdrachten. Een metaveld zonder definitie kan niet worden bijgehouden.
  • De machtiging Toegang tot gegevens over voorraadoverdrachten. Verleen deze machtiging op de pagina Machtigingen van de app; zie Toestemmingen en toegang tot gegevens.

1. Houd het metaveld bij

  1. Open Metaveld-triggers in de app en klik op Trigger toevoegen.
  2. Kies het resourcetype Overdracht.
  3. Vink het metaveld aan, in dit geval Carrier reference. U kunt meerdere velden tegelijk aanvinken of de optie Alles selecteren gebruiken.
  4. 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.

Het dialoogvenster „Trigger voor metaveld toevoegen” met het resourcetype „Transfer” en het metaveld „Carrier reference” (custom.carrier_reference) aangevinkt
Bij het resourcetype ‘Overdracht’ is het metaveld aangevinkt. Bij ‘Alle metavelden’ worden in plaats daarvan alle metavelden van dit type bijgehouden.

De trigger wordt onmiddellijk geactiveerd. De eerste keer dat de app een voorraadoverdracht leest, slaat deze de huidige waarde op zonder een workflow te starten; elke wijziging daarna zet er wel een in gang.

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 TRANSFER
resourceId Het ID van de voorraadoverdracht, bijvoorbeeld gid://shopify/InventoryTransfer/1234567890
metafieldKey Naamruimte en sleutel, in dit geval custom.carrier_reference
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

  1. Maak in Shopify Flow een workflow aan en kies de trigger Metaveld Update van Workflow Trigger Extensions.
  2. Voeg een voorwaarde toe: resourceType is gelijk aan TRANSFER. De update van het metaveld wordt gestart voor elk resourcetype dat u bijhoudt, dus deze voorwaarde beperkt deze workflow tot voorraadoverdrachten. Wanneer u meerdere metavelden van dit type bijhoudt, voeg dan metafieldKey is gelijk aan custom.carrier_reference toe als tweede criterium.
  3. Voeg de gewenste actie toe. In het voorbeeld wordt een interne e-mail verzonden met de oude en de nieuwe waarde.
De voorbeeldworkflow in Shopify Flow: Metaveld bijwerken, een voorwaarde voor het resourcetype TRANSFER en een interne e-mail verzenden
De voorbeeldworkflow: de trigger, de voorwaarde op basis van het resourcetype en één actie.

Begin met het voorbeeld

  1. Download het .flow-bestand dat onderaan deze pagina is bijgevoegd.
  2. Open Shopify Flow in uw Shopify-beheerdersgedeelte, klik op Importeren en selecteer het bestand.
  3. Open de stap Interne e-mail verzenden en voer de ontvanger in. Het bestand bevat bewust geen adres.
  4. Schakel de workflow in.

Maak het tot het uwe

  • Voeg de voorwaarde „metafield.previousValue is leeg” toe, zodat de reactie alleen plaatsvindt wanneer het veld voor het eerst wordt ingevuld.
  • Verzend de referentie naar het systeem van het ontvangende magazijn met de functie HTTP-verzoek verzenden.
  • Voeg een voorwaarde toe voor metafieldKey wanneer u meerdere metavelden voor overboekingen bijhoudt.

Hoe snel reageert het?

Shopify stuurt hiervoor geen melding, dus de app leest de bijgehouden metavelden ongeveer één keer per minuut uit. U kunt de workflow binnen een minuut of twee verwachten.

Goed om te weten

  • Overboekingen die in de afgelopen 90 dagen zijn aangemaakt, worden in de gaten gehouden. Een wijziging in een metaveld van een oudere overboeking leidt niet tot het starten van een workflow.
  • Een nieuwe overdracht wordt pas na ongeveer een minuut waargenomen. Een waarde die het metaveld op dat moment al heeft, geldt als de beginwaarde en leidt niet tot het starten van een workflow; elke wijziging daarna doet dat wel.

Meer