8. Alerts

Alerts keep people informed without them having to watch lists. Start with a few alerts that matter and add more once you see how they read.

Alerts and triggered events

Where to find it: Admin › Alerts › Alerts and triggered events

Alerts send an email, post to a webhook, or record a note when something happens to a document: it is created, changed, or reaches a status. Alerts can also run on a schedule for promise dates and expiration dates; those run from the daily job, or at once with the Run due button on the Alerts page, and each fires at most once a day per document.

Alerts fire from sales orders, quotes, ship docs, customer returns, purchase orders, receivers, vendor returns, adjustments, transfers, work orders, repair orders, and payments. Every alert that fires is listed in the alert history with what was sent and whether it worked. Email alerts send only when company mail is connected.

Who can change these settings: Roles with the Company Edit right. Out of the box that is Admin and GM. Other roles see the page read-only.

Name, Description, and Active

The alert's name (used as the start of the email subject), a description added to the message, and whether it runs. Untick Active to pause an alert.

• Who can change it: Roles with the Company Edit right. Out of the box that is Admin and GM. Other roles see the page read-only.
• Example: "Big order": Description "Check stock before approving".

Type

The kind of record the alert watches, such as sales order, purchase order, or ship doc. Choose one type per alert.

• Who can change it: Roles with the Company Edit right. Out of the box that is Admin and GM. Other roles see the page read-only.
• Example: sales order.

Run after

When the alert runs: Create, Change, Change Status, Promise Date, Schedule, or Expiration. Use Change Status for most workflow alerts.

Promise Date and Schedule look at open sales orders and purchase orders whose promise date is today or past.

Expiration looks at lots and serials whose expiry date is today or past; it is offered only while Use expiration dates is on.

Delete and Custom Fields may appear in the list but do not fire alerts in the current release.

• Default: Create.
• Who can change it: Roles with the Company Edit right. Out of the box that is Admin and GM. Other roles see the page read-only.
• Example: Change Status with Status Shipped to tell sales an order went out.

Status

For Change Status, the status that fires the alert. Choose Any status to run on every status change.

• Default: Any status.
• Who can change it: Roles with the Company Edit right. Out of the box that is Admin and GM. Other roles see the page read-only.
• Example: Shipped.

Related to (email)

The address the alert is sent to. Leave it blank to send to the company email, or, if that is blank, to the person who made the change.

• Who can change it: Roles with the Company Edit right. Out of the box that is Admin and GM. Other roles see the page read-only.
• Example: sales@yourcompany.com.

For webhook only and Webhook address

Sends the alert to a web address instead of email: Invatrak posts the alert name, document type, number, trigger, and status as JSON. Use it to feed another system.

• Default: Off.
• Who can change it: Roles with the Company Edit right. Out of the box that is Admin and GM. Other roles see the page read-only.
• Example: https://example.com/hooks/alert.

Activity type

Email sends the message; Note only records it in the alert history without sending. Use Note while testing a new alert.

• Default: Email.
• Who can change it: Roles with the Company Edit right. Out of the box that is Admin and GM. Other roles see the page read-only.
• Example: Note for a trial week, then Email.

Form template to export and attach

Attaches the document as a PDF printed with the chosen form. Use it to send customers or staff the document itself.

• Default: None.
• Who can change it: Roles with the Company Edit right. Out of the box that is Admin and GM. Other roles see the page read-only.
• Example: Attach "Invoice - standard" when a ship doc is shipped.

Email template

Uses an active email template for the subject and body instead of the standard alert text. Choose the template for the same document type.

• Default: Alert text.
• Who can change it: Roles with the Company Edit right. Out of the box that is Admin and GM. Other roles see the page read-only.
• Example: Invoice template for a ship doc alert.

Form template

Prints the alert's PDF with this form when Form template to export and attach is empty. When that attach field is set, the attached form is the PDF.

• Default: None.
• Who can change it: Roles with the Company Edit right. Out of the box that is Admin and GM. Other roles see the page read-only.
• Example: Invoice - standard, with attach left at None.