Vendor Notifications

Last modified February 4, 2019

This article applies to Contextual Commerce. (Looking for Classic Commerce documentation?)

The Vendor Notifications feature allows you to configure customizable email messages that will be sent to you (or to specified third-party email addresses) each time certain triggering events occur. For example, you can configure a custom notice to be sent to a specific email address (or a list of addresses) each time a certain product is purchased. The Vendor Notifications menu is also where you can configure which email addresses will be used for all other (non-custom) publisher-facing email messages.

To configure Vendor Notifications, click the Settings menu in the Dashboard and then select the Vendor Notifications tab.

Settings menu with the Vendor Notifications tab selected
 

Default Settings

The Default Settings section displays the primary contact email address for the account by default.

Default Settings section of the Vendor Notifications menu with the EDIT command highlighted

You can click the EDIT command to configure the following settings:

SettingDescription
Outbound BCC Address

Optionally specify one or more email addresses that will be BCC'd on all outgoing customer-facing email messages (e.g. new order receipts, fulfillment email messages, etc.).

Tip

It is recommended that you enter a special e-mail address that is only used for this purpose, or create a mail routing rule to automatically file these messages, since entering
an address here will result in all customer-facing messages being copied to the specified address(es).
Primary Account ContactView and / or edit the First Name, Last Name and Email address of the primary contact person for your account. (This affects all of your Stores, not just the current one.)
Store Notification AddressesIf your account has more than one Store, you can configure separate Default Email Addresses and Alert Email Addresses for each Store.
  • Default Email Address - Enter one or more email addresses (use commas to separate multiple addresses) that will be used for all Store notifications by default.
  • Alert Email Address - Optionally enter separate email address(es) to be used for certain alert messages (e.g. low license availability). If you specify one or more Alert Email
    Addresses, alert messages will not be sent to the Default Email Address(es), but all other Store messages will still be sent there.


Custom Emails

The Custom Emails section lists all custom vendor notifications (there are none configured by default) and allows you to add new notifications or edit notifications you have previously created. In the example image below, we have already created a custom notification to be sent when returns are completed for a certain product, and another for returns processed in a certain specific Store.


Example of the Custom Emails section of the Vendor Notifications sub-menu

To configure a custom vendor notification

You can create new vendor notifications using the following process. The images below provide an example of creating a notification to be sent when a certain product is purchased.

  1. Click ADD in the Custom Emails section. The Setup page will appear.

    Setup page

  2.  Click the drop-down selector for the Event Type and choose which type of event will trigger messages to be sent via this notification.

    Example of selecting an Event Type of Order Completed
     
  3. Click NEXT. A basic notification will be created, and the you can customize it.
  4. Three pages of options will become available: General, Conditions and Advanced. We will take a look at the options on each page in a moment. You can click  at any time (on any page) to save your changes.
  5. The Custom Email Template section, which contains the notification template that controls the content of the messages that will be sent, appears at the bottom of all three pages.

    Example of the Custom Email Template section
     
  6. Context-specific Help is available based on the Event Type selected in step 2. In this example, clicking the order link will open a popup window that lists some of the order object variables you can reference in the Contents of the notification.

    The Order popup window, which lists some of the order object variables available
     
  7. The Subject field lets you control the subject line of messages that will be sent via this notification.
  8. The Contents area lets you control the actual contents of messages that will be sent via this notification.

  9. On the General page, the Name field allows you to optionally enter a name for the new notification.


     
  10. The Email Address List field lets you optionally enter one or more email addresses to which messages will be sent via this notification. If you enter more than one address, use commas to separate them. If you leave this field blank (which is the default value), messages for this notification will be sent to the default address for the Store.
  11. The Conditions page allows you to configure the specific circumstances under which messages will be sent for this notification. In the Applicable Site field, you can click the drop-down and select the Store to which the notification will apply (or select Applies to all to have the notification apply to all Stores).

    The Conditions page of a vendor notification
     
  12. In the Rule Applicability field, you can specify whether the notification will apply for Rebills Only (meaning automatic scheduled subscription transactions), Non-Rebills Only (meaning new orders), or all orders (Always Applies).
  13. The Products field lets you specify which products will trigger messages to be sent via this notification. You can optionally click Add Product to open the Add Product pop-up window, where you can click a drop-down selector to choose a specific product and then click ADD.

    Example of the Add Product popup window

    More than one product can be specified by repeating this step; if you do not specify any product, then the notification will be used for all transactions matching the selected Event Type.
     
  14. The Condition Expression field lets you optionally enter an expression using logical evaluation to further narrow the circumstances under which messages will be sent for this notification. More information about using logical evaluation can be found in the Template Reference. As with the Custom Email Template section of the page, context-specific Help is available based on the selected Event Type. In the example image above, clicking the order link would open a popup window that lists some of the order object variables you can reference in the Condition Expression.
  15. The Advanced page lets you control the character encoding that will be used for messages sent via this notification. This may be helpful in some cases when you plan to implement a script to parse the incoming notification messages. Click the drop-down selector for the Character Encoding field and select whether the messages will use UTF-8 encoding (the default value) or ISO-8859-1 encoding.
  16. Remember to click  when you are finished, to save your changes. The new notification will appear on the Vendor Notifications page.