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

Shopify events: order-cancel

Het order-cancel-event wordt, zoals de naam al aangeeft, getriggerd wanneer een bestelling wordt geannuleerd in je Shopify-webshop. Dit wordt middels een webhook doorgegeven aan Copernica, waardoor er, zodra dit gebeurt, 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.total_price}: de totaalprijs van de bestelling
  • {$trigger.webhook.created_at}: het tijdstip waarop de bestelling geplaatst is
  • {$trigger.webhook.customer}: de klant die de bestelling geplaatst heeft
  • {$trigger.webhook.customer.first_name}: de voornaam van de klant die de bestelling geplaatst heeft
  • {$trigger.webhook.line_items}: een lijst van de producten in de bestelling
  • {$trigger.webhook.total_discounts}: de gegeven korting op een bestelling
  • {$trigger.webhook.shipping_address}: het adres waarop de bestelling bezorgd wordt

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: annuleringsbevestiging

Met de volgende Smarty-code halen we de naam van de klant op en vermelden we welke producten er in de geannuleerde bestelling zaten:

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

Je bestelling van de volgende items is geannuleerd:
{foreach $trigger.webhook.line_items as $item}
  - {$item.name}: ({$item.quantity}x) voor {$item.price}
{/foreach}