How To: Setup Email Trigger Rules
Contents
 | Creating and Editing Email Trigger Rules is an Advanced User feature. |
Email Trigger Rules prompt the system into creating and in some instances automatically sending emails from Khaos Control. They are used in conjunction with Message Templates.
- Open an Email Manager screen.
- Press the Trigger Rules radio button and click "GO" to display existing trigger rules.
Note: existing trigger rules can be opened by double clicking on them in the list. - Press Ctrl+N or click
to create a new trigger rule. - Assign a code to the trigger rule and enter this in the "Rule Code" field.
- Add a trigger rule description in the "Rule Description" field.
- Select the desired type from the "Trigger Type" drop-down to define the area here this rule is to be triggered:
- CAT REQUEST: for emails generated in relation to something happening in the cat request process. The following conditions will populate the left-hand "Available Conditions" grid below:
- OLD STATUS
- NEW STATUS
- INVOICE: for emails generated in relation to something happening the Invoice Manager. The following conditions will populate the left-hand "Available Conditions" grid:
- COMPANY CLASS
- CONSIGNMENT REF
- COURIER
- COURIER GROUP
- CUSTOMER COUNTRY
- CUSTOMER OPTIONS (these are from the Additional Options on the company screen)
- EXPORT TYPE
- FIRST INVOICE
- INVOICE PRIORITY
- SALE SOURCE
- SITE
- SORDER BRAND
- SORDER TYPE (e.g. Credit Note, Proforma Order, Quotation, Sales Order)
- UDA COMPANY
- UDA STOCK
- OLD INVOICE STATUS (i.e. Sales Invoice manager stage)
- NEW INVOICE STATUS (i.e. Sales Invoice manager stage)
- PURCHASE ORDER: for emails generated in relation to purchase ordering. The following condition will populate the left-hand "Available Conditions" grid below:
- UPDATE STATUS
- RETURN: emails are sent when the return is saved, see How To: Setup and Send Return Emails. The
- MULTIPLE REASONS: this is a checkbox and does not limit the return to single return reasons, for example when multiple items have been returned.
- RETURN BRAND: the brand from the customer's return.
- RETURN REASON: the single return reason as setup in System Data.
- SO ACKNOWLEDGE: for Sales Order Acknowledgements (Basic Reports Version) emails generated in relation to something happening the Invoice Manager. The following conditions will populate the left-hand "Available Conditions" grid:
- COMPANY CLASS
- CONSIGNMENT REF
- COURIER
- COURIER GROUP
- CUSTOMER COUNTRY
- CUSTOMER OPTIONS (these are from the Additional Options on the company screen)
- EXPORT TYPE
- FIRST INVOICE
- INVOICE PRIORITY
- SALE SOURCE
- SITE
- SORDER BRAND
- SORDER TYPE (e.g. Credit Note, Proforma Order, Quotation, Sales Order)
- UDA COMPANY
- UDA STOCK
- OLD INVOICE STATUS (i.e. Sales Invoice manager stage)
- NEW INVOICE STATUS (i.e. Sales Invoice manager stage)
- SOURCE SAFE: used for technical purposes on some systems.
- CAT REQUEST: for emails generated in relation to something happening in the cat request process. The following conditions will populate the left-hand "Available Conditions" grid below:
- Select the message template that is to be used with the trigger rule.
- Tick the "Subscribers Only" checkbox to only send the email to customers with E-Mailing List Subscriber ticked in their
[ Customer |Detail | Address ]tab. - Tick the "Attach PDF" checkbox to attach a copy of the document (report) to the email.
- Tick the "Send Email Immediately" checkbox if the email is to be automatically sent and not held in the Pending emails section.
- Tick the "Active" checkbox when you wish the Trigger Rule to be enabled.
Note: this may be after you have finished creating and testing the Trigger Rule. - Add the required available conditions to the right-hand "Active Conditions" grid using the
button. - Enter the appropriate comparison symbol:
- <: less than
- <=: less than or equal to
- =: equal
- >: greater than
- >=:greater than or equal to
- <>: NOT
- For each condition:
- click in the "Lookup Value" column and press Ctrl+F8 to display the "Make a Selection" dialog box.
- Select the desired criteria from the dialog's drop-down selection box and press "OK"; the criteria will then be shown in the right-hand "Active Conditions" grid.
- Repeat as required to add another condition.
Note: All active conditions have to be true at the same time in order for the rule to work; see examples below. - Press Ctrl+S or click
to save the Trigger Rule.
Manually Sent Emails
Not all areas have the ability to send automatic emails, these Trigger Types are:
- BACK ORDER: sent manually to let customers know about changes to their back orders, see How To: Setup Emails to be sent based on your Purchase Order Line Status and How To: Send Emails based on your Purchase Order Line Status.
- COMPANY EMAIL: for customer-based emails (for example, letting customers know about a new special offer).
- MANUAL: for emails that do not fit into the above categories (this format can use an external csv file to provide the available tags for the template).
- REFUND: refund emails are generated using the Other Actions Menu option in the Sales Returns screen, see How To: Setup Payment Refund Emails and How To: Send Payment Refund Emails.
- REPORT EMAIL: used for manually emailing reports generated in Khaos Control.
Examples
Rules that work
Example One
The following trigger rule examples will work.
The old invoice status was equal to ORDERS - AWAITING STOCK, the new invoice status is equal to ORDERS - RELEASED and this is for all customers with a Company Class of Retail.
Example Two
When a new Purchase Order is created it will be emailed to the supplier.
Rules that don't work
Example Three
The following trigger rules will NOT work.
The old invoice status was equal to ORDERS - AWAITING STOCK and the new invoice status is equal to ORDERS - RELEASED and the Company Class of the customers is Retail and the Company Class of the customers is Personal. Customers cannot belong to more than one Company Class. A separate trigger rule would need to be created for each company class.
Example Four
The old invoice status was equal to ORDERS - AWAITING STOCK and ORDERS - AWAITING DATE and ORDERS - MANUAL HOLD and ORDERS - TERMS HOLD and the new invoice status is equal to ORDERS - RELEASED. This will not work because orders cannot be in all four stages in the Future Folder at the same time. Four separate trigger rules would need to be created for each stage in the Future folder.