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

Alle velden die teruggegeven worden door de Shopify Admin API voor een order zijn beschikbaar. Deze variabelen zijn direct 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.first_name}: 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.

Webhook attributen

Wanneer je een van bovenstaande velden gebruikt, worden de gegevens automatisch opgevraagd bij jouw Shopify webshop. Dit kan er echter voor zorgen dat het opbouwen van een e-maildocument wat langer duurt. In veel gevallen staan de gegevens die je wilt gebruiken al rechtstreeks in de webhook data vanuit Shopify. Deze kun je gebruiken met de {$trigger.webhook} Smarty-variabele. De beschikbare velden kun je vinden in de Shopify-documentatie. Het is sterk aangeraden om zoveel mogelijk deze attributen te gebruiken, aangezien dit API calls naar je webshop scheelt, waardoor je mails sneller kunnen opbouwen, en je niet tegen een rate limit van de API aan loopt.

Handige attributen

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

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.attributes.customer.first_name},

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