Home > Documentatie > Integraties > Shopify > Extra opvolgacties > Order-Update

Shopify events: order-update

Het order-update-event wordt, zoals de naam al aangeeft, getriggerd wanneer een bestelling wordt bijgewerkt in de Shopify-webshop. Dit wordt middels een webhook doorgegeven aan Copernica, waardoor er, zodra een bestelling aangepast is, opvolgacties uitgevoerd kunnen worden.

Variabelen

Bij Shopify-events zijn variabelen op twee manieren beschikbaar:

  • Webhook-data via {$trigger.webhook}: deze informatie komt rechtstreeks uit de webhook die Shopify naar Copernica stuurt.
  • API-data via {$trigger}: deze informatie wordt opgehaald via de Shopify GraphQL Admin API.

Wij adviseren om zoveel mogelijk gebruik te maken van de webhook-data. Hiermee voorkom je extra API-calls, bouw je e-mails sneller op en loop je minder snel tegen de rate limits van Shopify aan.

Webhook-data

Zodra Copernica een order-event ontvangt vanuit Shopify, zijn alle velden uit de Shopify-webhook beschikbaar via de {$trigger.webhook}-variabelen in opvolgacties en mailings, bijvoorbeeld {$trigger.webhook.id}.

Handige variabelen

De volgende velden zijn vaak handig om te gebruiken in opvolgacties en mailings:

  • {$trigger.webhook.notify_customer}: of de klant op de hoogte gebracht moet worden
  • {$trigger.webhook.line_items[].additions}: een lijst van de producten toegevoegd aan de bestelling
  • {$trigger.webhook.line_items[].removals}: een lijst van de producten verwijderd uit de bestelling

API-data

Alle velden die teruggegeven worden door de Shopify Admin API voor een order zijn beschikbaar via de 'trigger'-variabelen in opvolgacties en mailings, bijvoorbeeld: {$trigger.id}.

Handige variabelen

De volgende velden zijn vaak handig om te gebruiken in opvolgacties en mailings:

  • {$trigger.totalPriceSet.presentmentMoney}: de totaalprijs van de bestelling
  • {$trigger.createdAt}: het tijdstip waarop de bestelling geplaatst is
  • {$trigger.customer}: de klant die de bestelling geplaatst heeft
  • {$trigger.customer.firstName}: de voornaam van de klant die de bestelling geplaatst heeft
  • {$trigger.lineItems}: een lijst van de producten in de bestelling
  • {$trigger.totalDiscountsSet.presentmentMoney}: de gegeven korting op een bestelling
  • {$trigger.shippingAddress}: het verzendadres van de bestelling

Meer informatie over de beschikbar velden en het gebruik vind je in dit artikel.

Voorbeeld: bevestiging van aanpassing

Met de volgende Smarty-code halen we de naam van de klant op en vermelden we welke producten er zijn toegevoegd aan en verwijderd uit de bestelling. Let op dat je de $shopify-variabele bijwerkt met de identifier van je integratie.

Beste {$trigger.webhook.customer.firstName},

De volgende items zijn toegevoegd aan je bestelling:
{foreach $trigger.webhook.line_items.additions as $item}
  {assign item="product" value=$shopify.product[$item.id]}
  - {$item.delta}x: {$product.title}
{/foreach}

De volgende items zijn verwijderd uit je bestelling:
{foreach $trigger.webhook.line_items.removals as $item}
  {assign item="product" value=$shopify.product[$item.id]}
  - {$item.delta}x: {$product.title}
{/foreach}