Skip to main content

Triggers

Required Permissions

An employee must be assigned to the shop with a Shop Owner Admin role to perform actions referred to in this article.

A Trigger is an action or number of actions that ShopCtrl will perform on a configured event. Triggers are used to send emails to customers, webhooks to external party applications, for setting up your own system of customized order statuses. With the triggers, you could set up your fulfillment process and define a moment when the stock will be allocated for order.

Triggers could be created on a shopowner level and applied to all shop groups. And could be as well shop-specific, for example, when it is needed to use different email templates for shops.

The diagram below shows a typical order flow that is automated with four triggers, from payment to invoice.

⚡ TRIGGERRuns automatically in ShopCtrl. Click a trigger to see its setup.Step in your order process
Typical order flow with triggersThe customer pays, trigger 1 allocates stock. If all order rows are in stock, trigger 2 creates the shipment. If not, trigger 3 creates a backorder alert, and trigger 2 creates the shipment once the stock arrives. After the warehouse ships the order, trigger 4 creates the invoice and emails it.Customer pays the orderTRIGGER 1WHENOrder payments doneTHENAllocate stockAll order rowsin stock?NoTRIGGER 3WHENOrder has one or moreorder rows not in stockTHENCreate alertYesTRIGGER 2WHENOrder stock status changedIFBase status is FinishedTHENCreate shipmentStock arrivesWarehouse picks, packs and shipsTRIGGER 4WHENShipment shippedTHEN1. Create invoice for shipped items2. Send email with the invoice

How triggers work​

Every trigger is made of three parts:

  • Event - the change in ShopCtrl that starts the trigger, for example New order added. See Trigger events.
  • Trigger condition (optional) - options that narrow down when the trigger fires, for example only when the order reaches a specific status.
  • Actions - what ShopCtrl does when the trigger fires, for example send an email or create a shipment. Actions run in the order they appear in the list. See Trigger actions.

Create a trigger​

  1. Go to Configuration > Triggers.
  2. Click Add to create a new trigger.
  3. Enter a Title.
  4. Select the Event that should start the trigger.
  5. (Optional) Set the options in the Trigger condition panel. The options depend on the event.
  6. Select the shop owner, or a Shop to make the trigger shop-specific.
  7. Click Add action and select an action. Repeat for each action you need.
  8. Check Enabled.
  9. Click Save or Save and close.

For ready-made setups, see Trigger examples.