Magento events: order-create

Het order-create-event wordt, zoals de naam al aangeeft, getriggerd wanneer een nieuwe bestelling wordt aangemaakt in de Magento-webshop. Copernica vraagt elke minuut de nieuwe bestellingen op en voert alle opvolgacties uit die zijn gekoppeld aan dit event.

Variabelen

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

Handige variabelen

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

  • {$trigger.grand_total}: de totaalprijs van de bestelling
  • {$trigger.created_at}: het tijdstip waarop de bestelling geplaatst is
  • {$trigger.customer}: de klant die de bestelling geplaatst heeft
  • {$trigger.customer.name}: de naam van de klant die de bestelling geplaatst heeft
  • {$trigger.items}: een lijst van de producten in de bestelling
  • {$trigger.discount_amount}: de gegeven korting op een bestelling
  • {$trigger.payment}: betaalgegevens over de bestelling
  • {$trigger.payment.method}: de betaalmethode van een bestelling (let op de . tussen payment en method)
  • {$trigger.billing_address}: het factuuradres van de bestelling
  • {$trigger.shipping_assignments}: de verzendadressen van de bestelling

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

Attributen

Als je een veld exact wilt gebruiken zoals het is aangeleverd, kun je dit doen met de {$trigger.attributes}-variabele (meer informatie). Deze variabele bevat alle velden uit de integratie in hun oorspronkelijke vorm, zonder aanpassingen door Copernica.

Voorbeeld: bestelbevestiging

Met de volgende Smarty-code halen we de naam van de klant op en vermelden we welke producten er zijn besteld:

Beste {$trigger.customer.firstname},

Bedankt voor je bestelling van:
{foreach $trigger.items as $item}
  - {$item.name} ({$item.qty_ordered}x) voor {$item.price}
{/foreach}

Voorbeeld: productgegevens opslaan

Soms kan het handig zijn om in Copernica een aparte database te maken met productinformatie. Bijvoorbeeld om per product bij te houden hoe vaak het is besteld, of wanneer de laatste bestelling is. Hoewel dergelijke informatie ook vanuit de Magento-database is uit te lezen, is het soms makkelijker om het ook in een aparte Copernica-database op te slaan.

In een opvolgactie kun je naar aanleiding van een order-create-event een opvolgactie maken. Je gebruik een herhaal-box om door de bestelde producten te itereren (deze zijn toegankelijk via de {$trigger.items}-variabele), en daarna kun je elke item afzonderlijk gebruiken om een profiel of subprofiel aan te maken of bij te werken.