The Kibo Composable Commerce Platform (KCCP) supports sending messages about order/shipment updates to consumers and store associates. Consumers can receive emails about their orders, including a series of notifications to help the customer stay in contact with the retailer about their pickup orders.
For more detailed information about the specialized notifications included with Curbside Delivery, refer to the Curbside Delivery guide in addition to this introductory walkthrough.
Consumer Emails
Consumer emails are automatically triggered by KCCP, based on events such as order creation and shipment. While a number of emails are supported by KCCP, some may be enabled/disabled for a site through the site theme and Admin UI email settings. Their templates can be customized as Hypr files in the site theme.
Email Settings
The supported email templates for the current site can be viewed under System > General Settings > Email. These emails are grouped by topic and include all of the available STH, BOPIS, Transfer, and Curbside Delivery notification emails. For more information about these topics and when each email is triggered, see the General Settings guide.
Toggle individual emails on to enable automatic sending from KCCP or toggle them off to disable the send. If emails are going to be managed through a third-party application, then they must be disabled here because the application will be configuring the email sends, not Kibo.
Note that in the case of BOPIS orders with an alternate pickup contact (in which the customer indicated another person may receive the order), fulfillment emails will be delivered to both the primary customer and the additional contact. This includes Order Confirmation, Order Cancellation, Order Pickup Ready, Partial Pickup Ready, In Transit Confirmation, Backorder, Backorder Date Update, Order Pickup Reminder, Item Cancelled, Shipment Confirmation, and the Curbside Delivery emails.
Overriding Email Options
Default sender and reply options must be set in the sender fields above the list of topics, but clicking the pencil icon on any individual email will open a list of settings that overrides the defaults on that particular email. This may be useful if an email needs to come from a different alias or have replies handled differently from other email cases.
Templates
All notification templates are installed on the site theme, where the default versions can be customized with business branding and adjustments to their formatting.
You can customize your fulfillment email and store notification templates in the site theme. They can also be viewed in the Content Editor, though you cannot edit them there.
View Templates
To view templates in the Admin UI:
- Go to Main > Content > Editor.
- Click Pages > Email Templates in the navigation menu on the right.
- Click a template to view it on the page.
Customize Templates in the Site Theme
Email data is populated from the KCCP APIs, so the content is limited to what is provided through those APIs. Neither default nor customized templates can transform any data, only display the data as it is given. For instance, a string with the value "Product Name : Shirt" cannot be changed to say "Shirt." However, if the email needs to expose data that isn't provided by an existing field in the relevant API then that data can usually be configured as a custom data field if supported by the API.
Below is an example of a customized template. For more detailed instructions about how to edit theme files and general email templates, see the Theme documentation.
Hypr Theme Editing
Hypr can also be used for editing consumer emails when there is not a third-party application installed to facilitate the editing process. The template files are stored on the site theme, so in order to update them client developers should make their edits to the files in a local git repository and push the new versions to their KCCP site theme.
The Hypr theme editing process that should be followed is documented here.