Utkast till order - utlösare för metafält

Utkast till order - utlösare för metafält

Kopiera sidan

Starta ett Shopify Flow-arbetsflöde när ett metafält i ett orderutkast ändras. Spåra det i Workflow Trigger Extensions och hämta det gamla och det nya värdet.

Ett säljteam hanterar offerter som orderutkast och anger status i metafältet ”Offertstatus” (custom.quote_status) för orderutkastet. När en offert övergår till statusen approved ska den som ska skicka fakturan underrättas.

På den här sidan beskrivs hur man startar ett Shopify Flow-arbetsflöde när ett metafält i ett orderutkast ändras, med hjälp av Workflow Trigger Extensions. Stegen är desamma för alla metafält av denna resurstyp; i exemplet används offertstatus (custom.quote_status).

Vad du behöver

  • En metafältdefinition. Skapa den i din Shopify-admin under Inställningar > Metafält och metaobjekt > Utkast till beställningar. Ett metafält utan definition kan inte spåras.
  • Behörigheten ”Draft Order Data Access”. Bevilja den på appens sida för behörigheter, se Behörigheter och åtkomst till data.

1. Spåra metafältet

  1. Öppna ”Metafield-utlösare” i appen och klicka på ”Lägg till utlösare”.
  2. Välj resurstypen ”Utkast till order”.
  3. Markera metafältet, i detta fall ”Citatstatus”. Du kan markera flera samtidigt eller använda ”Välj alla”.
  4. Klicka på ”Lägg till utlösare”.

För att spåra alla metafält för den här resurstypen, inklusive de som du skapar senare, väljer du ”Alla metafält” istället för att markera enskilda fält och klickar sedan på ”Spåra alla metafält”.

Dialogrutan ”Lägg till metafältutlösare” med resurstypen ”Utkast till order” och metafältet ”Offertstatus”, custom.quote_status, markerat
Resurstyp: Utkast till order, metafältet är markerat. ”Alla metafält” spårar istället alla metafält av den typen.

Den nya utlösaren visar ”Initialiserar” medan appen läser in det aktuella värdet för metafältet i dina befintliga orderutkast, och därefter ”Aktiv”. Det är tack vare den första avläsningen som den allra första ändringen redan kommer med rätt tidigare värde.

Om metafältet saknas i listan klickar du på ”Uppdatera metafält” på sidan ”Metafältutlösare”: appen lagrar listan med definitioner i en timme.

2. Vad arbetsflödet tar emot

Varje ändring utlöser händelsen ”Metafield Update” i Shopify Flow med följande värden:

Variabel Värde
resourceType DRAFTORDER
resourceId ID-numret för orderutkastet, till exempel gid://shopify/DraftOrder/1234567890
metafieldKey Namnområde och nyckel, här custom.quote_status
metafield.value Det nya värdet
metafield.previousValue Värdet före ändringen; tomt när metafältet angavs för första gången
metafield.type Metafältets typ, till exempel single_line_text_field

3. Skapa arbetsflödet

  1. I Shopify Flow skapar du ett arbetsflöde och väljer utlösaren ”Metafield Update” från Workflow Trigger Extensions.
  2. Lägg till ett villkor: resourceType är lika med DRAFTORDER. Uppdateringen av metafältet startar för varje resurstyp som du spårar, så villkoret begränsar detta arbetsflöde till utkast till order. Om du spårar flera metafält av den här typen, lägg till metafieldKey är lika med custom.quote_status som ett andra kriterium.
  3. Lägg till den åtgärd du behöver. I exemplet skickas ett internt e-postmeddelande med det gamla och det nya värdet.
Exempel på arbetsflöde i Shopify Flow: Uppdatering av metafält, ett villkor för resurstypen DRAFTORDER och skicka internt e-postmeddelande
Exempel på arbetsflöde: utlösaren, villkoret för resurstypen och en åtgärd.

Börja med exemplet

  1. Ladda ner .flow-filen som finns bifogad längst ner på denna sida.
  2. Öppna Shopify Flow i din Shopify-admin, klicka på Importera och välj filen.
  3. Öppna steget ”Skicka internt e-postmeddelande” och ange mottagaren. Filen innehåller avsiktligt ingen adress.
  4. Aktivera arbetsflödet.

Gör den till din egen

  • Lägg till ett villkor på metafield.value så att det endast reagerar på approved.
  • Märk utkastet: använd åtgärden ”Lägg till taggar för utkast” och ange {{resourceId}} i fältet för utkastets ordning.
  • Skicka ändringen till ditt CRM-system med funktionen ”Skicka HTTP-förfrågan”.

Hur snabbt den reagerar

Shopify meddelar appen när ett orderutkast sparas, så arbetsflödet startar vanligtvis inom några sekunder.

Mer